vpopmail Install Instructions

Clark_LIU_Xinyu

vpopmail Install Instructions
Author: clark dot liu [at] howau dot org
Version: 0.40407
1.        check for disksapce
# df
or
# df –k
2.        add groups and users and home directory
# groupadd –g 89 vchkpw
# useradd –g vchkpw –u 89 vpopmail
If you want to place the vpopmail home dir in a different disk partition than the default home dir location try:
# useradd –g vchkpw –u 89 –d /path/to/where/you/want vpopmail
3.        FAST default install
$ su
# ./configure
# make
# make install-strip
If you are making vpopmail for roaming users to be able to relay through your smtp server after the authenticate with pop do:
$ su
# ./configure –enable-roaming-users=y
# make
# make install-strip
configure option recommendations for new sites
--enable-clear-passwd=y (store a clear text copy of users password)
--enable-valias=y (turn on vpopmail alias processing)
--enable-mysql-relication=y
4.        Check your ~vpopmail/etc/tcp.smtp file
5.        Setup crontab for –enable-roaming-users=y
Add a line to roots crontab
$ su
# crontab –e
add a line like the following:
40 * * * * /home-dir-of-vpopmail/bin/clearopensmtp 2>;&1 >; /dev/null
6.        Add a virtual domain
For this example, we will add a domain “infotech-consultant.com”
# cd /home-dir-of-vpopmail/bin
# ./vadddomain infotech-consultant.com
or
# ./vadddomain infotech-consultant.com password-for-postmaster
vadddomain will modify the following qmail files
/var/qmail/control/locals
/var/qmail/control/rcpthosts
/var/qmail/control/morercpthosts (if rcpthosts >; 50 lines)
/var/qmail/control/virtualdomains
/var/qmail/users/assign
/var/qmail/users/cdb
It will also create a domains directory
~vpopmail/domains/infotech-consultant.com
~vpopmail/domains/infotech-consultant.com/postmaster/Maildir
~vpopmail/domains/infotech-consultant.com/vpasswd
~vpopmail/domains/infotech-consultant.com/vpasswd.cdb
If you do not specify a password on the command line, it will prompt for a password for the postmaster.
Then it will send a kill –HUP signal to qmail-send telling it to re-read the control files.
7.        Add a new pop user
You can install qmailadmin and administer your new pop mail system via a web interface. Or you can use the command line interface.
# cd /home-dir-of-vpopmail/bin
# ./vadduser newuser@infotech-consultant.com
or
# ./vadduser newuser@infotech-consultant.com <password-for-newuser>;
In the case where the domain is specified (user@domain.com), the user is added to the ~vpopmail/domains/domain.com directory. If you don’t enter a password on the command line, it will prompt for a password.
8.        Delete a pop user
# cd /home-dir-of-vpopmail/bin
# ./vdeluser newuser@infotech-consultant.com
9.        Delete a virtual domain
# cd /home-dir-of-vpopmail/bin
# ./vdeldomain infotech-consultant.com
10.        Changing a pop users password
# cd /home-dir-of-vpopmail/bin
# ./vpasswd user@infotech-consultant.com
or
# ./vpasswd user@infotech-consultant.com password-for-user@infotech-consultant.com
11.        Information details hiding
12.        How to use vchkpw with qmail-pop3d server
env – PATH=”/var/qmail/bin:/usr/local/bin” \
tcpserver –H –R 0 pop-3 \
/var/qmail/bin/qmail-popup infotech-consultant.com \
/home-dir-of-vpopmail/bin/vchkpw /var/qmail/bin/qmail-pop3d Maildir &
Appendix A: vpopmail Install Instructions
Appendix B: vpopmail Online manual pages
Appendix C: Internet Mail
Appendix D: vpopmail - virtual domains for qmail
Appendix E: TLS + SMTP Auth patch
Appendix F: exim Internet Mailer