diff --git a/DOCUMENTS/POSTFIXADMIN.TXT b/DOCUMENTS/POSTFIXADMIN.TXT new file mode 100644 index 00000000..90a16171 --- /dev/null +++ b/DOCUMENTS/POSTFIXADMIN.TXT @@ -0,0 +1,20 @@ + +--------------------------------------- + The different parts of PostfixAdmin + +/admin directory scripts are used by superadmins, also known as 'site admins'. +When you log in as a superadmin you'll be running scripts from /admin that +won't bother checking to see if you are allowed to admin for a domain. As +a superadmin you can add and remove domains, mailboxes, aliases, domain admins, +and create more superadmins. A superadmin will be not stopped from doing +anything, so be careful, you can delete your our login account. + +login.php sorts out what type of admin you are and sends you to the right place. +The scripts in / are used by domain admins and always check to see if you are +an admin for the domain (or user within a domain) you are attempting to change. + +End user scripts only do operations on the currently logged in user. +If the end user options provide more than you want your users to have, +check the user options in config.inc.php, or, even better, edit the +user templates and remove the options. + diff --git a/DOCUMENTS/SUPERADMIN.TXT b/DOCUMENTS/SUPERADMIN.TXT new file mode 100644 index 00000000..f3ca06d8 --- /dev/null +++ b/DOCUMENTS/SUPERADMIN.TXT @@ -0,0 +1,36 @@ + + +------------------------------------ + Recreating a superadmin account + + +The database scripts DATABASE_MYSQL.TXT and DATABASE_PGSQL.TXT create a super admin + of admin@domain.tld, password: admin + +With that login you can create new superadmins (and you should delete or change the +password of admin@domain.tld). If that user is no longer there or you didn't use +the .TXT files, you could add another manually from the database. Just use the code +from one of the .TXT files. Do this as root on the MySQL machine: + +# mysql +Welcome to the MySQL monitor. Commands end with ; or \g. +Your MySQL connection id is 8186 to server version: 5.0.27 + +Type 'help;' or '\h' for help. Type '\c' to clear the buffer. + +mysql> use postfix +Reading table information for completion of table and column names +You can turn off this feature to get a quicker startup with -A + +Database changed +mysql> INSERT INTO domain_admins (username, domain, active) VALUES ('new@domain.tld','ALL','1'); +Query OK, 1 row affected (0.00 sec) + +mysql> INSERT INTO admin (username, password, active) VALUES ('new@domain.tld','$1$0fec9189$bgI6ncWrldPOsXnkUBIjl1','1'); +Query OK, 1 row affected (0.00 sec) + +mysql> exit +Bye + +Then you can log in as new@domain.tld, password: admin + diff --git a/INSTALL.TXT b/INSTALL.TXT index 51b19526..eab87f47 100644 --- a/INSTALL.TXT +++ b/INSTALL.TXT @@ -56,6 +56,10 @@ 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 ------------ @@ -63,13 +67,13 @@ 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 view, located at http://domain.tld/postfixadmin/admin/. +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 password for the Site Admin view of Postfix Admin is admin/admin. +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. @@ -85,3 +89,7 @@ specified to host Postfix Admin. ------------------- 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