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