Vpopmail Administration

This section deals only with the administration of VPOPmail. If you want to know how email arrives in the proper directory read this guide: EmailProblemsAndSolutions.

vadddomain

The MX server is configured through the vpopmail commands:

# /home/vpopmail/bin/vadddomain d2222.co.uk password
# killall -HUP qmail-send
# grep "d2222.co.uk" /var/qmail/users/assign
+d2222.co.uk-:d2222.co.uk:508:503:/home/vpopmail/domains/d2222.co.uk:-:: # ls -la /home/vpopmail/domains/d2222.co.uk/
total 28
drwx- 3 vpopmail vchkpw 4096 oct 11 14:18 .
drwx- 50 vpopmail vchkpw 4096 oct 11 14:18 ..
-rw- 1 vpopmail vchkpw 34 oct 11 14:18 .dir-control
drwx- 3 vpopmail vchkpw 4096 oct 11 14:18 postmaster
-rw- 1 vpopmail vchkpw 55 oct 11 14:18 .qmail-default
-rw- 1 vpopmail vchkpw 126 oct 11 14:18 vpasswd
-rw- 1 vpopmail vchkpw 2196 oct 11 14:18 vpasswd.cdb
-rw- 1 vpopmail vchkpw 0 oct 11 14:18 .vpasswd.lock
# cat /home/vpopmail/domains/d2222.co.uk/.qmail-default
| /home/vpopmail/bin/vdelivermail '' bounce-no-mailbox
# cat /home/vpopmail/domains/d2222.co.uk/vpasswd
postmaster:$1$mY6Wb$2BjlmBGnIck3trJpHaG/.:1:0:Postmaster:/home/vpopmail/domains/d2222.co.uk/postmaster:NOQUOTA: motdepasse


We've created an account with vadddomain for the domain d2222.cco.uk, plus we've restarted qmail-sent so that it takes the newly created domain at /var/qmail/users/assign. In the folder for the domain, that's /home/vpopmail/domains/d2222.co.uk, vadddomain has created by default the postmaster account (that's an obligation from the RFC) and it has put in place .qmail-default where you'll find the vdelivermail that manages the distribution of email in the folders.

You can see the password for the accounts at vpasswd. That's an option which could worry some customers, but it's not dangerous in itself. All the vpopmail folders belong to vpopmail.vchkpw and cannot be read by anybody but vpopmail or root. You can recompile vpopmail to put the option to remove them.

You can perform this test to see if the email gets to the account locally:

# /usr/sbin/sendmail -t
to: postmaster@d2222.co.uk
subject: test

test
{ctrl-d]
# tail -f /var/log/qmail/current
@400000003f87f6a827c897dc new msg 66212
@400000003f87f6a827c8b334 info msg 66212: bytes 230 from qp 6334 uid 0
@400000003f87f6a8293b1f54 starting delivery 67446: msg 66212 to local d2222.co.uk-postmaster@d2222.co.uk
@400000003f87f6a8293b32dc status: local 1/10 remote 0/20
@400000003f87f6a82a072d9c delivery 67446: success: did_0+0+1/
@400000003f87f6a82a073d3c status: local 0/10 remote 0/20
@400000003f87f6a82a074124 end msg 66212


Thus, the email has been delivered to the local. Therefore, it must be at:
/home/vpopmail/domains/d2222.co.uk/postmaster

# cd /home/vpopmail/domains/d2222.co.uk/postmaster/Maildir/new/
# ls -l
total 4
-rw- 1 vpopmail vchkpw 292 oct 11 14:25 1065875102.6336.nsxxxx.ovh.net,S=230
# cat 1065875102.6336.nsxxxx.ovh.net,S=230
Return-Path:
Delivered-To: postmaster@1
Received: (qmail 6334 invoked by uid 0); 11 Oct 2003 12:25:01 -0000
Date: 11 Oct 2003 12:24:46 -0000
Message-ID: <20031011122446.6331.qmail@nsxxx.ovh.net>
From: root@nsxxx.ovh.net
to: postmaster@d2222.co.uk
subject: test

test


The only thing pending is to buy the domain and configure the DNS so that your machine is the MX server for the domain.

vadduser

To create a new email account, use the tool vadduser.

# /home/vpopmail/bin/vadduser webmaster@d2222.co.uk password
# ls -la /home/vpopmail/domains/d2222.co.uk
total 32
drwx- 4 vpopmail vchkpw 4096 oct 11 14:29 .
drwx- 50 vpopmail vchkpw 4096 oct 11 14:18 ..
-rw- 1 vpopmail vchkpw 34 oct 11 14:29 .dir-control
drwx- 3 vpopmail vchkpw 4096 oct 11 14:18 postmaster
-rw- 1 vpopmail vchkpw 55 oct 11 14:18 .qmail-default
-rw- 1 vpopmail vchkpw 249 oct 11 14:29 vpasswd
-rw- 1 vpopmail vchkpw 2341 oct 11 14:29 vpasswd.cdb
-rw- 1 vpopmail vchkpw 0 oct 11 14:29 .vpasswd.lock
drwx- 3 vpopmail vchkpw 4096 oct 11 14:29 webmaster
# cat /home/vpopmail/domains/d2222.co.uk/vpasswd
postmaster:$1$mY6Wb$2BjlmBGnIck3trJpHaG/.:1:0:Postmaster:/home/vpopmail/domains/d2222.co.uk/postmaster:NOQUOTA: a_password
webmaster:$1$evJxi$IPRLq.RjZCuBOXEv/m5Nw/:1:0:webmaster:/home/vpopmail/domains/d2222.co.uk
/webmaster:NOQUOTA: a_password


vdeluser

To delete a pop account, use the tool vdeluser.

# /home/vpopmail/bin/vdeluser webmaster@d2222.co.uk



vpasswd

To change the password from an account, vpasswd:


# /home/vpopmail/bin/vpasswd postmaster@d2222.co.uk another_password
# cat /home/vpopmail/domains/d2222.co.uk/vpasswd
postmaster:$1$tElbV$9L0bkQSm2/XvP62ebNA7X.:1:0:Postmaster:/home/vpopmail/domains/d2222.co.uk/postmaster:NOQUOTA: a_password



vsetuserquota

To configure a quota of 25MB for a POP3/IMAP account:

# /home/vpopmail/bin/vsetuserquota postmaster@d2222.co.uk 25000000
# cat /home/vpopmail/domains/d2222.co.uk/vpasswd
postmaster:$1$tElbV$9L0bkQSm2/XvP62ebNA7X.:1:0:Postmaster:/home/vpopmail/domains/d2222.co.uk/postmaster:25000000: a_password


vmoduser

To block the access to a POP3/IMAP account:

# /home/vpopmail/bin/vmoduser -p postmaster@d2222.co.uk
# cat /home/vpopmail/domains/d2222.co.uk/vpasswd
postmaster:$1$tElbV$9L0bkQSm2/XvP62ebNA7X.:1:2:Postmaster:/home/vpopmail/domains/d2222.co.uk/postmaster:25000000:a_password


To unblock the account and allow the access to the email through POP3/SMTP server:

# /home/vpopmail/bin/vmoduser -x postmaster@d2222.co.uk
# cat /home/vpopmail/domains/d2222.co.uk/vpasswd
postmaster:$1$tElbV$9L0bkQSm2/XvP62ebNA7X.:1:0:Postmaster:/home/vpopmail/domains/d2222.co.uk/postmaster:25000000:a_password



vdeldomain

To delete all the domain d2222.co.uk, we use vdeldomain. Attentionn: if the domain is highly used or/and operations exists on the domain, the deletion won't be successful.

# /home/vpopmail/bin/vdeldomain d2222.co.uk