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.
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