|
|
|
|
#
|
|
|
|
|
# Postfix Admin
|
|
|
|
|
# by Mischa Peters <mischa at high5 dot net>
|
|
|
|
|
# Copyright (c) 2002 - 2005 High5!
|
|
|
|
|
# Licensed under GPL for more info check GPL-LICENSE.TXT
|
|
|
|
|
#
|
|
|
|
|
|
|
|
|
|
REQUIRED!!
|
|
|
|
|
----------
|
|
|
|
|
- You are using Postfix 2.0 or higher.
|
|
|
|
|
- You are using Apache 1.3.27 / Lighttpd 1.3.15 or higher.
|
|
|
|
|
- You are using PHP 4.1 or higher (5.X recommended)
|
|
|
|
|
- You are using MySQL 3.23 or higher (5.x recommended)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
READ THIS FIRST!
|
|
|
|
|
----------------
|
|
|
|
|
When this is an upgrade from Postfix Admin 1.5.4 please read DOCUMENTS/UPGRADE.TXT!!
|
|
|
|
|
|
|
|
|
|
If you need to setup Postfix to be able to handle Virtual Domains and Virtual
|
|
|
|
|
Users check out :
|
|
|
|
|
|
|
|
|
|
- http://high5.net/howto/
|
|
|
|
|
- http://codepoets.co.uk/docs/postfix_postgresql_postfixadmin_courier_howto (Postfix+PostgreSQL+Courier+Postfixadmin)
|
|
|
|
|
- http://bliki.rimuhosting.com/space/knowledgebase/linux/mail/postfixadmin+on+debian+sarge (Postfix+MySQL+Postfixadmin+Dovecot)
|
|
|
|
|
- http://gentoo-wiki.com/HOWTO_Setup_a_Virtual_Postfix/Courier_Mail_System_with_PostfixAdmin (Postfix+MySQL+Postfixadmin+Courier)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1. Unarchive new Postfix Admin
|
|
|
|
|
------------------------------
|
|
|
|
|
Make sure that you are in your WWW directory and then unarchive the
|
|
|
|
|
Postfix Admin archive (whatever the filename is):
|
|
|
|
|
|
|
|
|
|
$ tar -zxvf postfixadmin-2.2.0.tgz
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2. Change permissions
|
|
|
|
|
----------------------
|
|
|
|
|
Since the database password is stored in the config.inc.php it's a good idea
|
|
|
|
|
to have change the permissions for Postfix Admin (the following assumes the files
|
|
|
|
|
are owned by the same user as the web server is running as - e.g. www-data).
|
|
|
|
|
|
|
|
|
|
$ cd /var/www/postfixadmin
|
|
|
|
|
$ chmod 640 *.php *.css
|
|
|
|
|
$ cd /var/www/postfixadmin/admin/
|
|
|
|
|
$ chmod 640 *.php .ht*
|
|
|
|
|
$ cd /var/www/postfixadmin/images/
|
|
|
|
|
$ chmod 640 *.gif *.png
|
|
|
|
|
$ cd /var/www/postfixadmin/languages/
|
|
|
|
|
$ chmod 640 *.lang
|
|
|
|
|
$ cd /var/www/postfixadmin/templates/
|
|
|
|
|
$ chmod 640 *.tpl
|
|
|
|
|
$ cd /var/www/postfixadmin/users/
|
|
|
|
|
$ chmod 640 *.php
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
3. Create the Database Tables
|
|
|
|
|
--------------------------
|
|
|
|
|
In DATABASE_MYSQL.TXT you can find the table structure for MySQL that you need
|
|
|
|
|
in order to configure Postfix Admin and Postfix in general to work with
|
|
|
|
|
Virtual Domains and Users.
|
|
|
|
|
|
|
|
|
|
In DATABASE_PGSQL.TXT you can find the table structure for PostgreSQL.
|
|
|
|
|
|
|
|
|
|
Check out the file first to see what you are about to do, then for MySQL do
|
|
|
|
|
something like this:
|
|
|
|
|
|
|
|
|
|
mysql -u root < DATABASE_MYSQL.TXT
|
|
|
|
|
|
|
|
|
|
4. Configure
|
|
|
|
|
------------
|
|
|
|
|
Check the config.inc.php file. There you can specify settings that are
|
|
|
|
|
relevant to your setup.
|
|
|
|
|
|
|
|
|
|
Postfix Admin contains 3 views of administration.
|
|
|
|
|
|
|
|
|
|
- Site Admin (aka superadmin) view, located at http://domain.tld/postfixadmin/admin/.
|
|
|
|
|
- Domain Admin view, located at http://domain.tld/postfixadmin/.
|
|
|
|
|
- User Admin View, located at http://domain.tld/postfixadmin/users/.
|
|
|
|
|
|
|
|
|
|
In order to do the initial configuration you have to go to the Site Admin view.
|
|
|
|
|
|
|
|
|
|
The default user/password for the Site Admin view of Postfix Admin is admin@domain.tld/admin
|
|
|
|
|
|
|
|
|
|
5. Done
|
|
|
|
|
-------
|
|
|
|
|
This is all that is needed. Fire up your browser and go to the site that you
|
|
|
|
|
specified to host Postfix Admin.
|
|
|
|
|
|
|
|
|
|
6. More information
|
|
|
|
|
-------------------
|
|
|
|
|
As of March 2007, PostfixAdmin moved to SourceForge. For the
|
|
|
|
|
forum posts and source updates, see:
|
|
|
|
|
https://sourceforge.net/projects/postfixadmin
|
