FAQ Table of ContentsIntroFeatures for vpopmail  FAQ0. How can I set one virtual domain to be the primary domain for   the machine? We don't want to have any /etc/passwd users.1. How to I pop in to pick up my virtual domain email?2. How do I forward all mail that doesn't match any pop users or .qmail3. How do I bounce all mail that doesn't match any pop users or .qmail4. How do I allow roaming users to use our smtp server without opening5. What is a sample start script for the pop server?6. How do hard quota's for users work?7. I installed qmail in a place other than /var/qmail. How should8. I want to use a different file name than /etc/tcp.smtp for my9. How can we use an IP address per domain, so that users don't need10. Why was the name of the package changed from vchkpw to vpopmail?11. Logging? Please tell me about logging12. How do I alias a new virtual domain to a current virtualdomain?13. How do I post a email to all users of a virtualdomain or a set    of domains?14. Is there a mailing list available for vpopmail package?15. How do I setup vpopmail to talk to mysql?16. I want to upgrade vpopmail, what do I need to worry about?17. Will IMAP work with vpopmail?18. Can I use vpopmail with IMP (www.horde.org/imp)?19. What is the difference between the --enable-large-site=y or n20. How do I control the database and table names in mysql21. Why can't pop authenticate on my slackware installation? 22. How do I forward all email to a different site?23. How come, about every hour or so, everything stops working?24. We are using NFS and sometimes things break! 25. How to use ssh tunnels with pop?26. vaddomain fails on my Debian qmail installation27. How do I log when people authenticate with pop? 28. How do I compile sqwebmail with vpopmail and mysql?29. How can I uninstall vpopmail? 30. I get errors about not finding a .so library, how to fix?31. What is the relationship between ~vpopmail/etc/open-smtp~vpopmail/etc/tcp.smtp and ~vpopmail/etc/tcp.smtp.cdb and how do they work withthe smtpserver?32. I don't want to bounce emails for non existent users. Instead I want    to delete them, how?33. Quota usage doesn't decrease after deleting messages with qmail-pop3d!34. How do I get Courier-IMAP use vpopmail's "roaming users"?35. How to run vadddomain as non root36. I want to have vpopmail access mysql as vpopmail and not root. What     sql commands to I run? 37. Is there commerical support available?Intro---------------------------------------------------------------vpopmail is a collection of programs to automate creation andmaintence of non /etc/passwd virutal domain email and pop accounts for qmail installations.Two additional packages support the vpopmail package:qmailadmin provides a simple web based administration interface for pop account maintence, forwards, aliases, mailing lists and autoresponders.  http://sourceforge.net/projects/qmailadmin/Sqwebmail provides a hot mail type web email system whichreads directly from the disks Maildirs, local, NFS or NAS.and autoresponders.  http://www.inter7.com/sqwebmail/Features for vpopmail---------------------------------------------------------------- uses one uid/gid for all email accounts  two types of email addresses  1) for domains in /var/qmail/control/locals the email     addresses are:  user@any-domain-in-locals-file     pop authentication user name is: user     admin programs are: vadduser, vdeluser, vpasswd        vadduser username optional-command-line-password -a (optional apop)        vdeluser username         vpasswd  username optional-command-line-password -a (optional apop)  2) for "virtual" domains in /var/qmail/control/virtualdomains     addresses are of the form user@virtualdomain     pop authentication user name is: 	 user%virtualdomain or user@virtualdomain depending on email client     admin programs are: vadddomain, vdeldomain, vpasswd        vadddomain virtualdomain optional-command-line-password-for-postmaster                    -a (optional apop)        vdeldomain virtualdomain         vadduser username@virtualdomain optional-command-line-password             -a (optional apop)        vdeluser username@virtualdomain optional-command-line-password            -a (optional apop)        vpasswd  username@domainname optional-command-line-password  NOTE: for all of the above commands that take passwords: If the       password is not specified,it will prompt the command line       for it untill two successive entries match.- automated and complete command line program to add a new   virtual domain:     admin program: vadddomain virtualdomain optional-postmaster-password         -a (for apop)    This program does the following:         updates /var/qmail/control/rcpthosts        updates /var/qmail/control/virtualdomains        updates /var/qmail/users/assign        updates /var/qmail/users/cdb        runs /var/qmail/bin/qmail-newu        sends hup signal to qmail-send to accept new domain- disk limit hard quota for all users under the single uid/gid  default is 50Meg per user- automates opening up smtp relay for roaming users  works in conjunction with the qmail-smtpd server run under  tcpserver with the optional -x /etc/relayip.cdb feature- email delivery is complete and allow for .qmail processing  per domain and folder spliting per domain/user  fully supports forwards, aliases, mailing lists, autoresponders  or any other program which uses the dot-qmail syntax- handles all email that does not match a pop user or .qmail in these ways:    a) delivers to a pop account    b) forwards to another email address    c) bounces    customizable in .qmail-default file per domain- efficent and written in c- supports /etc/passwd users as well as single uid/gid users- requires qmail and tcpserver to fully operate all features- can be used in scripts or programs to automate virtual domains and  users account management- tested on redhat 6.0, 5.2 (no shadow, default), solaris 5.7  should work on other systems too. possible porting issue  with format of ps command arguments- simplified installation.  uses configure ; make ; make install   configuration parameters allow for customizing to a sites disk layout  auto detechs shadow or non shadow authentication per platform  FAQ---------------------------------------------------------------0. How can I set one virtual domain to be the primary domain for   the machine? We don't want to have any /etc/passwd users.   configure vpopmail with this option:       --enable-default-domain=<domain name>   If you have already configured vpopmail you will need to do it   again. make distclean ; ./configure < with your options > ; make    make install-strip;   Then you can create the default domain with vadddomain <domain name>   This will allow users of the primary domain to set thier   pop user name to <user> instead of <user>%<virtualdomain> 1. How do I pop in to pick up my virtual domain email?   Virtual domain users need to use the following format for thier   user name when popping in:        user%virtual_domain_name   Eudora might require the following syntax        user%virtual_domain_name@pophost   Microsoft clients may the following syntax:        user@virtual_domain      If you don't include the %virtual_domain_name, vpopmail will    assume it is either a /etc/passwd user or a vpop user in    ~vpopmail/users or configured with "default domain".2. How do I forward all mail that doesn't match any pop users or .qmail   files for a particular domain?   Edit the ~vpopmail/domains/virtual_domain/.qmail-default file and    change the last parameter to an email address of the form: user@domain3. How do I bounce all mail that doesn't match any pop users or .qmail   files for a particular domain?   Edit the ~vpopmail/domains/virtual_domain/.qmail-default file and    change the last parameter to "bounce-no-mailbox" without the quotes.   For example:   # more .qmail-default   | /home/vpopmail/bin/vdelivermail '' bounce-no-mailbox 4. How do I allow roaming users to use our smtp server without opening   the machine up to everyone on the internet?    Your startup script for the qmail smtp server must use the    tcpserver -x file command similar to this startup line.     env - PATH="/var/qmail/bin:/usr/local/bin" \    tcpserver -H -R -x /path/to/vpopmail/etc/tcp.smtp.cdb \	-c20 -u504 -g503 0 smtp \    /var/qmail/bin/qmail-smtpd 2>&1 > /dev/null &Here are our qmail /etc/passwd entriesalias:x:503:503::/var/qmail/alias:/bin/bashqmaild:x:504:503::/var/qmail:/bin/bashqmaill:x:505:503::/var/qmail:/bin/bashqmailp:x:506:503::/var/qmail:/bin/bashqmailq:x:507:504::/var/qmail:/bin/bashqmailr:x:508:504::/var/qmail:/bin/bashqmails:x:509:504::/var/qmail:/bin/bash    modify the -u503 and -g503 to match your systems     qmaild user id and group id   Configure vpopmail with an additional option --enable-roaming-users=y   Then edit the /path/to/vpopmail/etc/tcp.smtp file and put in lines for all   static IP's that you will always want to allow relay access to.   For example:    127.0.0.:allow,RELAYCLIENT=""    10.1.1.:allow,RELAYCLIENT=""   The above lines will allow the localhost and all machines on the 10.1.1 C   class to relay thru.   You should always put in the 127.0.0 and the IP of the machine    vpopmail is running on and any aliased IPs.   Then run the following command   /path/to/vpopmail/bin/clearopensmtp   Then, every time someone pops in and authenticates, the follow happens:        1) vpopmail asks for an exclusive lock on the 		   ~vpopmail/etc/open-smtp.lock file        2) it will wait for the lock, once it gets it, it will continue        3) it adds the pop users IP into ~vpopmail/etc/open-smtp file with a            time stamp. If the IP already exsists, it updates the timestamp.        4) it runs tcprules to regenerate the /etc/tcp.smtp.cdb file        5) releases lock and new IP becomes available to the next            smtp invocation.    At this point, the smtp server configured above will allow that    IP to relay for 1 hour (default).    You should setup cron to run the following:        40 * * * * /home/vpopmail/bin/clearopensmtp     Change /home/vpopmail to be your vpopmails home dir.    clearopenstmp will ask for a lock, clear out any roaming IP's     whos timestamps are over 1 hour old since last pop authentication.    merges the two files vpopmail does above and run tcprules.     Thus closing off relay for those aged IPs.    I think it's pretty cool :)5. What is a sample start script for the pop server?    env - PATH="/var/qmail/bin:/usr/local/bin" \    tcpserver 0 pop-3 /var/qmail/bin/qmail-popup orbital.inter7.com \    /home/vpopmail/bin/vchkpw /var/qmail/bin/qmail-pop3d Maildir &6. How do hard quota's for users work?    When mail is delivered to a virtual domain, vdelivermail    will deliver it to the pop users directory. vdelivermail    will enter the users Maildir and add up the sizes of all     the files in these directories. If the size is greater    than the HARD_QUOTA limit. The email is bounced back to    the sender.    Use the default_quota and default_maxmsgcount options in    ~vpopmail/etc/vlimits.default or the .qmailadmin-limits    file for the domain to change the default quota for new    users.  The program vmoduser can be used to update quotas    for existing accounts.  Please read README.quotas for more    information on maildirquotas and syntax information.7. I installed qmail in a place other than /var/qmail. How should   I configure vpopmail for it?   ./configure --enable-qmaildir=qmail-install-path8. I want to use a different file name than /etc/tcp.smtp for my   static IPs for perment relay.   ./configure --enable-tcpserver-file=smtp-relay-file9. How can we use an IP address per domain, so that users don't need   to authenticate with user%domain or user@domain,    they just want to use "user"?   ./configure --enable-ip-alias-domains=y   Then run vipmap -a IP domain for each IP you want to link to a domain.10. Why was the name of the package changed from vchkpw to vpopmail?    Because no one could pronounce vchkpw and vpopmail is more descriptive.    V for virtual, pop for pop server, mail for mail!11. Logging? Please tell me about logging    ./configure --enable-logging=         y means log all successful and unsucessful attemps and fatal errors        n means don't log anything        e means only log errors and fatal errors        p means include passwords in errors        v means log everything, including passwords in errors    By default we set it up to only log errors and fatal errors.12. How do I alias a new virtual domain to a current virtualdomain?    vaddaliasdomain new_domain old_domain13. How do I post a email to all users of a virtualdomain or a set    of domains?    use the new vpopbull program:    vpopbull -f email_file vdomain vdomain ...    To see all the available options run vpopmail with no options.    It will print out a complete list.14. Is there a mailing list available for vpopmail users?    Yes. Send a message to vchkpw-subscribe@inter7.com15. How do I setup vpopmail to talk to mysql?    Read the README.mysql file.16. I want to upgrade vpopmail, what do I need to worry about?    Two things happen on an upgrade. The programs, library and	include files get over written and the permissions get fixed. 	None of the users or domain get touched. So to upgrade:    1) download new vpopmail software    2) ./configure with your options    3) make    4) make install-strip    5) upgrade completed.    If you want to backup the programs, libraries and include files	then back up ~vpopmail/bin, ~vpopmail/include and ~vpopmail/lib17. Will IMAP work with vpopmail?Yes. Here's a quick way to get up and running with Courier-IMAP   using both authpam (/etc/passwd) and vchkpw for auth:a) Download the Courier-IMAP available at Inter 7's Courier-IMAP    site.b) Configure it (as a NON-root user) with the following option: