AeroMail: Configure
This is the AeroMail Configuration Page. To set up AeroMail for your system, proceed as follows:
  1. If you are installing AeroMail for the first time, either make the AeroMail directory writable by the web server's user, or create an empty, writable
  2. If you are upgrading from a previous version of AeroMail:
    • Copy the file or from your old installation to AeroMail's directory.
    • If the file is called, rename it to
    • Make sure you have a backup of
    • Make sure is writable by the web server's user.
  3. Fill in the form below.
  4. When you press the 'Configure' button, a new will be written. The changes will be reflected in the form immediately; if you made changes e.g. to the colours, this page will be coloured differently.
  5. When you are done making changes, choose 'Go to AeroMail'.
  6. If all is working properly, make sure you make the file "read-only".
  7. For extra safety, remove configure.php from the AeroMail directory on your web server.

Go to AeroMail

AeroMail - a web-based e-mail client written in PHP
Copyright (C) 2000 Mark Cushman

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Server configuration

The name at the top of the window.

The server name or IP address of the IMAP server.

TCP port where the IMAP server is running - default is 143, SSL is 993

IMAP options may be necessary when connecting to an SSL-enabled server.

Server type. Use 'Cyrus' if you have a Courier IMAP server.

Directory for folders to be stored - applies to UWash servers only.
If server type is Cyrus, this var is not used.

Use cookies to login (and explicitly logout). Set to false to use
Basic Authentication.

Session save path: where your cookies; session data is stored. This should
be a secure directory that your users cannot access. Only used when

URL to redirect to when a user clicks on cancel when logging in.

Should AeroMail decide (force) what the user's e-mail address is, or should
AeroMail let sendmail and genericstable figure it out?

If you are using the FORCE_FROM, AeroMail will complete your e-mail
address with your IMAP_SERVER if necessary.
If your mail domain is different than the IMAP_SERVER setting above,
you can define a server suffix. AeroMail will send as user@SERVER_SUFFIX
instead of user@IMAP_SERVER.

If you see two INBOX's in your folder list, change the const below to true.

If you see headers and double line endings in mail sent from AeroMail,
or if attachments don't work, change this setting to true. qmail and
nullmailer have this problem.

Extra features

Include possibility to make, delete and use folders.
Set to false if you simply want to read and answer mail, e.g. when you
use POP at home and AeroMail when on the move.

Include possibility to write messages.
Set to false if you only want to read messages on the web.

Include possibility to delete messages.
Setting to false disables deletion of messages.

Folder to store sent messages in, e.g. "Sent".
Leave empty to disable sent mail storage.

Folder to store deleted messages in, e.g. "Trash".
Leave empty to disable deleted mail storage.

Include possibility to show e-mail headers.
If false, you can only read the message text.

Spam fighting:

If the subject matches this regular expression, mark message as spam.
This is useful if you have a mail server that can flag spam for you.
Leave empty if you don't want to use this feature.

If the message contains this header, mark message as spam.
This is useful if you have a mail server that can flag spam for you.
Leave empty if you don't want to use this feature.

Colon-separated list of spam blacklisters or open relay blacklisters. Keep
the list short, and put the fast ones first. Leave empty if you don't want
probable spam marked.
Example value:


More spam blacklisters:,,,,,,,,

Note: some blacklisters are *very* aggressive, check their sites for their

Automatically move spam to this folder (it will never appear in your
Leave empty if you want to delete manually.

Maximum time you want to wait for spam-flagging. When the connection
to spam blacklists is slow, this may hang AeroMail for a long time.
Setting this time will interrupt spam flagging.
Note that the current lookup will be finished.

Maximum time you want to wait for spam-flagging for each call. When
a call takes longer than this, the spam blacklist is considered down.
Don't set this value to low, as it may disable checking altogether.
Don't set it too high either, as a slow host may limit the number
of messages considered.

User interface

Change the path to this file to the desired theme file

Set this to your template file.

Default number of messages to display per screen

Should AeroMail display the To: field when listing messages in
folders other than Sent Items?

When displaying a folder list, should we display both the "personal"
name and the email address when available, or just the personal name?

If mail is addressed to many people, should AeroMail display the full
list in the overview or just some adresses?
Set to 0 for the full list.

Should AeroMail force word-wrap when displaying wide plaintext messages?

AeroMail can color text messages, by giving quoted lines and signatures
a different color. Set this empty if you don't want colorization.
Else set it to a colon separated string. The first color is for signatures;
The next list of colors are for quote level [1 .. x]. Colours should be
HTML colours, either by name or by hex code (e.g. #003399). Quoted lines
with a deeper level than the last color specified will be black.

Multi-message view allows you to check all messages you want to read and
then view them in one window. Set to false if you don't want this feature.


Change the path to this file to the desired language file

Warning: pressing 'Configure' will rewrite based on the contents of, if that exists. If you previously edited directly and changed anything else than option values, those changes will be lost.