Using the Unix shell

1. To unzip Vorras Mailer, if it is in .gz format:
   1. gunzip mailer-1.0.4.tar.gz
   2. tar xvf mailer-1.0.4.tar

1. unzip mailer-1.0.4.zip
2. cd mailer-1.0.4 make sure all *.cgi files have the first line pointing to the python interpreter
3. First make sure all files are located in a cgi enabled directory.

thelibs/index.cgi and admin.cgi

4) Point your browser to the install.cgi script found in this directory. Fill out all fields and proceed to the Administration Interface. A common problem here is incorrect file permissions make sure all Vorras Mailer files and directories are owned by the same user that can modify files from the internet. If on your system the user and group of cgi process are wwwuser and users respectively, do a chown -R wwwuser.users . in the Vorras Mailer directory and also in the images and mime attachments directories.

5) After you complete step 3, you will be redirected to the Administration Interface. Login using admin as username and admin as password. Please make sure you change the password.

6) After changing the password, make all necessary changes to make Vorras Mailer work on your system. Please refer to the Administrator's manual (file admin-mailer.pdf) for more details.

7) If you are running this in POP/IMAP only mode (no local accounts and no new user registration) start the mailerd daemon by typing:

./mailerd &

8) Try the system out by pointing your browser to the index.cgi script.

During installation, the most common problem is not having the correct file permissions to modify files. Check the user and group of files when written to by cgi scripts, and modify all Vorras Mailer files to have this user and group. If for example the user is wwwuser and the group is users you should execute:

chown -R wwwuser.users .

in the Vorras Mailer directory and also in the images and mime directories that are created during installation.

Point your browser to the admin.cgi script found in the Vorras Mailer distribution. If you followed the instructions in the README file, you should be redirected to the admin.cgi script automatically. Read the next section for more information on what each configuration option means.

If you have purchased a license for Vorras Antibot read Section 10 and complete the necessary configuration steps.

Once you finish with Vorras Mailer Administration Interface, point your browser to the index.cgi script and start using Vorras Mailer.

Note: if you are installing Vorras Mailer but are transferring users from other Vorras Mailer systems, or previous installations, first create all domain names on the Vorras Mailer Administration Interface and then move all the accounts_yourdomain directories in your data directory.