2 0fd75c45 2022-07-30 mischa # Postfix Admin
3 0fd75c45 2022-07-30 mischa # by Mischa Peters <mischa at high5 dot net>
4 0fd75c45 2022-07-30 mischa # Copyright (c) 2002 - 2005 High5!
5 0fd75c45 2022-07-30 mischa # License Info: http://www.postfixadmin.com/?file=LICENSE.TXT
10 0fd75c45 2022-07-30 mischa - You are using Postfix 2.0 or higher.
11 0fd75c45 2022-07-30 mischa - You are using Apache 1.3.27 or higher.
12 0fd75c45 2022-07-30 mischa - You are using PHP 4.1 or higher.
13 0fd75c45 2022-07-30 mischa - You are using MySQL 3.23 or higher.
16 0fd75c45 2022-07-30 mischa READ THIS FIRST!
17 0fd75c45 2022-07-30 mischa ----------------
18 0fd75c45 2022-07-30 mischa When this is an upgrade from Postfix Admin 1.5.4 please read UPGRADE.TXT!!
20 0fd75c45 2022-07-30 mischa If you need to setup Postfix to be able to handle Virtual Domains and Virtual
21 0fd75c45 2022-07-30 mischa Users check out http://high5.net/howto/
24 0fd75c45 2022-07-30 mischa 1. Unarchive new Postfix Admin
25 0fd75c45 2022-07-30 mischa ------------------------------
26 0fd75c45 2022-07-30 mischa Make sure that you are in your WWW directory and then unarchive the
27 0fd75c45 2022-07-30 mischa Postfix Admin archive (whatever the filename is):
29 0fd75c45 2022-07-30 mischa $ tar -zxvf postfixadmin-2.0.0.tgz
32 0fd75c45 2022-07-30 mischa 2. Change permissions
33 0fd75c45 2022-07-30 mischa ----------------------
34 0fd75c45 2022-07-30 mischa Since the database password is stored in the config.inc.php it's a good idea
35 0fd75c45 2022-07-30 mischa to have change the permissions for Postfix Admin.
37 0fd75c45 2022-07-30 mischa $ cd /usr/local/www/postfixadmin
38 0fd75c45 2022-07-30 mischa $ chmod 640 *.php *.css
39 0fd75c45 2022-07-30 mischa $ cd /usr/local/www/postfixadmin/admin/
40 0fd75c45 2022-07-30 mischa $ chmod 640 *.php .ht*
41 0fd75c45 2022-07-30 mischa $ cd /usr/local/www/postfixadmin/images/
42 0fd75c45 2022-07-30 mischa $ chmod 640 *.gif *.png
43 0fd75c45 2022-07-30 mischa $ cd /usr/local/www/postfixadmin/languages/
44 0fd75c45 2022-07-30 mischa $ chmod 640 *.lang
45 0fd75c45 2022-07-30 mischa $ cd /usr/local/www/postfixadmin/templates/
46 0fd75c45 2022-07-30 mischa $ chmod 640 *.tpl
47 0fd75c45 2022-07-30 mischa $ cd /usr/local/www/postfixadmin/users/
48 0fd75c45 2022-07-30 mischa $ chmod 640 *.php
51 0fd75c45 2022-07-30 mischa 3. Create the Database Tables
52 0fd75c45 2022-07-30 mischa --------------------------
53 0fd75c45 2022-07-30 mischa In DATABASE_MYSQL.TXT you can find the table structure for MySQL that you need
54 0fd75c45 2022-07-30 mischa in order to configure Postfix Admin and Postfix in general to work with
55 0fd75c45 2022-07-30 mischa Virtual Domains and Users.
57 0fd75c45 2022-07-30 mischa In DATABASE_PGSQL.TXT you can find the table structure for PostgreSQL.
60 0fd75c45 2022-07-30 mischa 4. Configure
61 0fd75c45 2022-07-30 mischa ------------
62 0fd75c45 2022-07-30 mischa Check the config.inc.php file. There you can specify settings that are
63 0fd75c45 2022-07-30 mischa relevant to your setup.
65 0fd75c45 2022-07-30 mischa Postfix Admin contains 3 views of administration.
66 0fd75c45 2022-07-30 mischa There is the Site Admin view, located at http://domain.tld/postfixadmin/admin/.
67 0fd75c45 2022-07-30 mischa There is the Domain Admin view, located at http://domain.tld/postfixadmin/.
68 0fd75c45 2022-07-30 mischa And there is the User Admin View, located at http://domain.tld/postfixadmin/users/.
70 0fd75c45 2022-07-30 mischa In order to do the initial configuration you have to go to the Site Admin view.
72 0fd75c45 2022-07-30 mischa The default password for the Site Admin view of Postfix Admin is admin/admin.
74 0fd75c45 2022-07-30 mischa This is specified in the .htpasswd file in the /admin directory. Make sure
75 0fd75c45 2022-07-30 mischa that the location of the .htpasswd file matches your path.
80 0fd75c45 2022-07-30 mischa This is all that is needed. Fire up your browser and go to the site that you
81 0fd75c45 2022-07-30 mischa specified to host Postfix Admin.
84 0fd75c45 2022-07-30 mischa 6. More information
85 0fd75c45 2022-07-30 mischa -------------------
86 0fd75c45 2022-07-30 mischa For more information you can go to the Postfix Admin forums.
87 0fd75c45 2022-07-30 mischa http://forums.high5.net/index.php?showforum=22
