You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
postfixadmin/INSTALL.TXT

96 lines
2.9 KiB
Plaintext

#
# 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.
- You are using MySQL 3.23 or higher.
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/
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.0.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.
$ cd /usr/local/www/postfixadmin
$ chmod 640 *.php *.css
$ cd /usr/local/www/postfixadmin/admin/
$ chmod 640 *.php .ht*
$ cd /usr/local/www/postfixadmin/images/
$ chmod 640 *.gif *.png
$ cd /usr/local/www/postfixadmin/languages/
$ chmod 640 *.lang
$ cd /usr/local/www/postfixadmin/templates/
$ chmod 640 *.tpl
$ cd /usr/local/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.
There is the Site Admin (aka superadmin) view, located at http://domain.tld/postfixadmin/admin/.
There is the Domain Admin view, located at http://domain.tld/postfixadmin/.
And there is the 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
This is specified in the .htpasswd file in the /admin directory. Make sure
that the location of the .htpasswd file matches your path.
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
-------------------
For more information you can go to the Postfix Admin forums.
http://forums.high5.net/index.php?showforum=22
As of March 2007, PostfixAdmin moved to SourceForge. For the
forum posts and source updates, see:
https://sourceforge.net/projects/postfixadmin