| 1 | <?xml version='1.0' encoding='UTF-8'?> |
1 | <?xml version='1.0' encoding='UTF-8'?> |
| 2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/virt-mail-howto.xml,v 1.52 2006/07/04 00:21:20 rane Exp $ --> |
2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/virt-mail-howto.xml,v 1.53 2006/09/04 08:49:44 nightmorph Exp $ --> |
| 3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 4 | |
4 | |
| 5 | <guide link="/doc/en/virt-mail-howto.xml"> |
5 | <guide link="/doc/en/virt-mail-howto.xml"> |
| 6 | <title>Virtual Mailhosting System with Postfix Guide</title> |
6 | <title>Virtual Mailhosting System with Postfix Guide</title> |
| 7 | |
7 | |
| … | |
… | |
| 21 | <abstract> |
21 | <abstract> |
| 22 | This document details how to create a virtual mailhosting system based upon |
22 | This document details how to create a virtual mailhosting system based upon |
| 23 | postfix, mysql, courier-imap, and cyrus-sasl. |
23 | postfix, mysql, courier-imap, and cyrus-sasl. |
| 24 | </abstract> |
24 | </abstract> |
| 25 | |
25 | |
| 26 | <version>1.1</version> |
26 | <version>1.2</version> |
| 27 | <date>2006-07-04</date> |
27 | <date>2006-09-04</date> |
| 28 | |
28 | |
| 29 | <!-- |
29 | <!-- |
| 30 | Contents |
30 | Contents |
| 31 | |
31 | |
| 32 | I. Introduction |
32 | I. Introduction |
| … | |
… | |
| 156 | qmail, or you will surely have BIG problems. |
156 | qmail, or you will surely have BIG problems. |
| 157 | </warn> |
157 | </warn> |
| 158 | |
158 | |
| 159 | <p> |
159 | <p> |
| 160 | After postfix is installed, it's time to configure it. Change the following |
160 | After postfix is installed, it's time to configure it. Change the following |
| 161 | options in <path>/etc/postfix/main.cf</path>: |
161 | options in <path>/etc/postfix/main.cf</path>. Remember to replace |
|
|
162 | <c>$variables</c> with your own names. |
| 162 | </p> |
163 | </p> |
| 163 | |
164 | |
| 164 | <pre caption="/etc/postfix/main.cf"> |
165 | <pre caption="/etc/postfix/main.cf"> |
| 165 | myhostname = $host.domain.name |
166 | myhostname = $host.domain.name |
| 166 | mydomain = $domain.name |
167 | mydomain = $domain.name |
| … | |
… | |
| 609 | Now enter the phpmyadmin page and browse the tables. You'll want to add in your |
610 | Now enter the phpmyadmin page and browse the tables. You'll want to add in your |
| 610 | local aliases, edit your user table to add a test user, and change your |
611 | local aliases, edit your user table to add a test user, and change your |
| 611 | transport table to add information about your domains. The default values |
612 | transport table to add information about your domains. The default values |
| 612 | supplied with the dumpfile should be a sufficient guide to what values need to |
613 | supplied with the dumpfile should be a sufficient guide to what values need to |
| 613 | go where. Make sure that if you put information in the database that it is |
614 | go where. Make sure that if you put information in the database that it is |
| 614 | accurate. For instance, make sure the local users home dir exists and that the |
615 | accurate. For instance, make sure the local user's home dir exists and that the |
| 615 | correct uid/gid values are in place. The maildirs should be created |
616 | correct uid/gid values are in place. The maildirs should be created |
| 616 | automatically by postfix when the user receives their first email. So, in |
617 | automatically by postfix when the user receives their first email. So, in |
| 617 | general, it's a good idea to send a "Welcome" mail to a new user |
618 | general, it's a good idea to send a "Welcome" mail to a new user after you |
| 618 | after you setup their account to make sure the .maildir gets created. |
619 | setup their account to make sure the .maildir gets created. |
| 619 | </p> |
620 | </p> |
| 620 | |
621 | |
| 621 | </body> |
622 | </body> |
| 622 | </section> |
623 | </section> |
| 623 | </chapter> |
624 | </chapter> |
| … | |
… | |
| 640 | # <i>chown vmail: /home/vmail</i> |
641 | # <i>chown vmail: /home/vmail</i> |
| 641 | </pre> |
642 | </pre> |
| 642 | |
643 | |
| 643 | <p> |
644 | <p> |
| 644 | So now when you're setting up vmail accounts, use the vmail uid, gid, and |
645 | So now when you're setting up vmail accounts, use the vmail uid, gid, and |
| 645 | homedir. When you're setting up local accounts, use that users uid, gid, and |
646 | homedir. When you're setting up local accounts, use that user's uid, gid, and |
| 646 | homedir. We've been meaning to create a php admin page for this setup but |
647 | homedir. We've been meaning to create a php admin page for this setup but |
| 647 | haven't gotten around to it yet, as phpmyadmin generally works fine for us. |
648 | haven't gotten around to it yet, as phpmyadmin generally works fine for us. |
| 648 | </p> |
649 | </p> |
| 649 | |
650 | |
| 650 | </body> |
651 | </body> |
| … | |
… | |
| 685 | # <i>/etc/init.d/courier-authlib restart</i> |
686 | # <i>/etc/init.d/courier-authlib restart</i> |
| 686 | # <i>/etc/init.d/saslauthd restart</i> |
687 | # <i>/etc/init.d/saslauthd restart</i> |
| 687 | </pre> |
688 | </pre> |
| 688 | |
689 | |
| 689 | <p> |
690 | <p> |
| 690 | We're almost there I promise! Next, set up the rest of the necessary config's |
691 | We're almost there, I promise! Next, set up the rest of the necessary configs |
| 691 | for postfix to interract with the database for all it's other transport needs. |
692 | for postfix to interract with the database for all its other transport needs. |
|
|
693 | Remember to replace each value with the name of your own user, user id, |
|
|
694 | password, alias, email address, and so on. |
| 692 | </p> |
695 | </p> |
| 693 | |
696 | |
| 694 | <pre caption="/etc/postfix/mysql-aliases.cf"> |
697 | <pre caption="/etc/postfix/mysql-aliases.cf"> |
| 695 | # <i>nano -w /etc/postfix/mysql-aliases.cf</i> |
698 | # <i>nano -w /etc/postfix/mysql-aliases.cf</i> |
| 696 | # mysql-aliases.cf |
699 | # mysql-aliases.cf |
| … | |
… | |
| 884 | documentation, including README.POSTFIX.gz, to understand what's being done |
887 | documentation, including README.POSTFIX.gz, to understand what's being done |
| 885 | here. |
888 | here. |
| 886 | </p> |
889 | </p> |
| 887 | |
890 | |
| 888 | <p> |
891 | <p> |
| 889 | One further note, current versions of mailman install to /usr/local/mailman. If |
892 | One further note, current versions of mailman install to |
| 890 | you're like me and wish to change the default install location, it can be |
893 | <path>/usr/local/mailman</path>. If you're like me and wish to change the |
| 891 | overridden in the ebuild file by changing the INSTALLDIR variable. |
894 | default install location, it can be overridden in the ebuild file by changing |
|
|
895 | the INSTALLDIR variable. |
| 892 | </p> |
896 | </p> |
| 893 | |
897 | |
| 894 | <pre caption="Install mailman"> |
898 | <pre caption="Install mailman"> |
| 895 | # <i>emerge mailman</i> |
899 | # <i>emerge mailman</i> |
| 896 | </pre> |
900 | </pre> |