Note: This functionality was removed in Archiveopteryx 3.1.3, due to lack of maintenance and use. Contact email@example.com if you want to use it.
The rest of this web page has been preserved, but we'll remove most links that point here.
This page explains how to use Archiveopteryx to make an existing mailing list archive accessible on the web, and keep it up-to-date with new list traffic.
Start by creating a mailbox to store the archived mail:
cd /usr/local/archiveopteryx bin/aox add mailbox /archives/example
Next, use aoximport to import existing archives into this mailbox (mbox, mh, cyrus, and maildir mailboxes are supported):
bin/aoximport -v /archives/example mbox example-*.mbox
To keep the database up to date with new mail, you can create an alias that delivers to the archive mailbox, and subscribe it to the list:
bin/aox add alias firstname.lastname@example.org /archives/example
First, you must create an anonymous user and grant them read-only access to your archive mailbox(es):
bin/aox add user anonymous anonymous email@example.com bin/aox setacl /archives/example anonymous lr
Next, configure Archiveopteryx to allow web access by adding the following to archiveopteryx.conf and restarting the server:
If you want to enable HTTPS for access to the archive, set the use-https, https-address, and https-port configuration variables. If you want to always require HTTPS, you can set allow-plaintext-access to never.
Your archives in general will now be accessible at
http://archives.example.org:8808, and the
mailbox will be at http://archives.example.org:8808/archives/example.
If you're already running Apache, you can use mod_proxy to integrate Archiveopteryx into your existing server's namespace using something like this in a VirtualHost section:
ProxyRequests Off ProxyPass / http://127.0.0.1:8808/ ProxyPassReverse / http://127.0.0.1:8808/
In this case, you can leave http-address at its default value of 127.0.0.1, since Archiveopteryx will see requests only when they're proxied through Apache. (This is the configuration we recommend.)
The archive-prefix configuration parameter controls where in the URL namespace archive mailboxes may appear. It is empty by default, so http://127.0.0.1:8808/archives/example interprets "/archives/example" as the name of a mailbox. If you set it to, say, "/foo", then your URLs will look like http://127.0.0.1:8808/foo/archives/example. (You will need to adjust Apache's ProxyPass directives to suit.)
If you have any questions, please write to firstname.lastname@example.org.
Last modified: 2010-11-19