VPopMail Configuration

Once everything is installed, it needs to be configured. Configuration is a pretty straightforward process.

  • Initial Configuration
rootshell> echo '127.:allow,RELAYCLIENT=""' >/home/vpopmail/etc/tcp.smtp
rootshell> cd ~vpopmail/etc
rootshell> tcprules tcp.smtp.cdb tcp.smtp.tmp < tcp.smtp
rootshell> ln -s /var/qmail/supervise/qmail-pop3d /var/qmail/supervise/qmail-pop3ds /service
rootshell> qmailctl popstat
  • Configuring vpopmail to use MySQL
First, create the mysql config file for vpopmail. This file contains 5 fields, each separated by a '|'.
  • Field 1 - Location of the MySQL Server
  • Field 2 - The port MySQL is running on
  • Field 3 - Login Name
  • Field 4 - Password
  • Field 5 - Database Name
As an example, the following tells vpopmail to connect to MySQL on the local machine using the default port, a login of vpopmailuser, a password of vpoppasswd, and a database name of vpopmail.
localhost|0|vpopmailuser|vpoppasswd|vpopmail
And to set this up, the following commands need to be run :
rootshell> echo "localhost|0|vpopmailuser|vpoppasswd|vpopmail" > ~vpopmail/etc/vpopmail.mysql
rootshell> chown vpopmail.vchkpw ~vpopmail/etc/vpopmail.mysql
rootshell> chmod 640 ~vpopmail/etc/vpopmail.mysql
  • MySQL Database Setup
Since vpopmail is now set up to talk to MySQL, I suppose we need to create the database. We'll do this by logging into MySQL as the root user, creating the database, and then granting access to it for the user we set up above. Don't worry about a database schema, vpopmail will create this automatically for you the first time it needs to add data.
shell> /usr/local/mysql/bin/mysql -u root -p
mysql> CREATE DATABASE vpopmail;
mysql> GRANT select,insert,update,delete,create,drop ON vpopmail.* TO vpopmailuser@localhost IDENTIFIED BY 'vpoppasswd';
mysql> quit
  • Setting the Default Limits
Review the contents of ~vpopmail/etc/vlimits.default. This file is used to set the default limits for any domains/mailboxes in the vpopmail system. Make sure it contains reasonable defaults for your system.
NOTE : bincIMAP does not yet support quotas. If your users will be using IMAP, make sure you do not set a quota in vpopmail or you're going to wind up with a nice headache...
  • Setting up the default domain
If you want to be able to offer some users the ability to login with just their username and not their full email address, you need to create this file and populate it with the default domain. All other users will need to use their full email address as their login name.
rootshell> echo "yourdomain.com" > /home/vpopmail/etc/defaultdomain


Page last modified on December 28, 2006, at 06:40 PM