Vmailmgr

From Qmailwiki
(Difference between revisions)
Jump to: navigation, search
Line 1: Line 1:
a virtual mail management package for qmail
+
== Preface ==
 
+
== Disclaimer ==
+
  
 
Throughout this document, I will assume that you are using an LWQ-esque setup, and will refer to many files in an LWQ-style installation.  If your setup differs from LWQ, you will have to interpret this document into your configuration.  LWQ is a very standard installation, and that is all I wish to try to support for this document.
 
Throughout this document, I will assume that you are using an LWQ-esque setup, and will refer to many files in an LWQ-style installation.  If your setup differs from LWQ, you will have to interpret this document into your configuration.  LWQ is a very standard installation, and that is all I wish to try to support for this document.
  
Also, this document assumes that the reader understands how to use tools such as 'tar' and 'gzip' and has basic experience compiling and installing software on a UNIX system.  If you are confused by 'extract the tarball', then you should probably take a few steps back and grab a UNIX for newbies book, or call in the [[Qmail-support|Professionals]]
+
Also, this document assumes that the reader understands how to use tools such as 'tar' and 'gzip' and has basic experience compiling and installing software on a UNIX system.  If you are confused by 'unpack the tarball', then you should probably take a few steps back and grab a UNIX for newbies book, or call in the [[Qmail-support|Professionals]]
  
 
== What is Vmailmgr? ==
 
== What is Vmailmgr? ==
Line 20: Line 18:
 
First you start by (obviously) having a qmail system installed.  I highly recommend using Dave Sill's [http://www.lifewithqmail.org Life With qmail] (LWQ) to get you started, as it leaves you with a nice base install to add vmailmgr atop of.   
 
First you start by (obviously) having a qmail system installed.  I highly recommend using Dave Sill's [http://www.lifewithqmail.org Life With qmail] (LWQ) to get you started, as it leaves you with a nice base install to add vmailmgr atop of.   
  
After you have qmail set up and running, head over to http://www.vmailmgr.org/ and grab the latest source tarball.
+
=== Installation ===
 +
 
 +
After you have qmail set up and running, head over to [http://www.vmailmgr.org/ vmailmgr.org],  grab the latest source tarball, and unpack it into wherever you keep your sources.
 +
 
 +
vmailmgr currently doesn't have very many compile-time configuration options available, such as switching database backends, etc, so I will not cover those here.  I use the standard configure, make, make install to install vmailmgr and it seems to work just fine.
 +
 
 +
# ./configure
 +
# make
 +
# make install
 +
 
 +
Once you've completed this, vmailmgr is ready to be implemented into your system!
 +
 
 +
=== Configuring password checking for vmailmgr ===
 +
 
 +
qmail provides an interface for checking passwords called [http://cr.yp.to/checkpwd/interface.html checkpassword].
 +
vmailmgr's checkvpw program is a drop-in, checkpassword-compatible authentication module.
 +
In order to authenticate users on a vmailmgr setup, you need to use checkvpw in all places where the checkpassword interface is used.
 +
With a LWQ setup, this is the pop3 server.
 +
Change <tt>/bin/checkpassword</tt> in your pop3 run script to <tt>/usr/local/bin/checkvpw</tt> (note, you may have to change the path based on your ./configure options) and restart your pop3d.
 +
 
 +
{{Box File|/service/qmail-pop3d/run|
 +
<pre>#!/bin/sh
 +
exec /usr/local/bin/softlimit -m 2000000 \
 +
    /usr/local/bin/tcpserver -v -R -H -l 0 0 110 /var/qmail/bin/qmail-popup \
 +
        FQDN /usr/local/bin/checkvpw /var/qmail/bin/qmail-pop3d Maildir 2>&1
 +
</pre>}}

Revision as of 18:10, 16 February 2005

Contents

Preface

Throughout this document, I will assume that you are using an LWQ-esque setup, and will refer to many files in an LWQ-style installation. If your setup differs from LWQ, you will have to interpret this document into your configuration. LWQ is a very standard installation, and that is all I wish to try to support for this document.

Also, this document assumes that the reader understands how to use tools such as 'tar' and 'gzip' and has basic experience compiling and installing software on a UNIX system. If you are confused by 'unpack the tarball', then you should probably take a few steps back and grab a UNIX for newbies book, or call in the Professionals

What is Vmailmgr?

vmailmgr is a simple and easy to use virtual mail management package for qmail. It provides a local delivery agent (vdeliver) for delivering mail to virtual users, a checkpassword replacement (checkvpw) for authentication, a courier-compatible auth module (authvmailmgr) for authenticating with courier-imap, courier-pop3d, and sqwebmail, and a suite of tools for managing users.

Why vmailmgr?

vmailmgr builds off the qmail principle that system users have full control over their own extension addresses in tandem with the qmail principle of handing virtual domain control over to the user. Each virtual domain is assigned to a system user, and all of the information about the domain is stored in that user's home directory. Vmailmgr is written in C so it is very fast, and has been proven to be a solid and stable platform for virtual domain management.

How do I use vmailmgr?

First you start by (obviously) having a qmail system installed. I highly recommend using Dave Sill's Life With qmail (LWQ) to get you started, as it leaves you with a nice base install to add vmailmgr atop of.

Installation

After you have qmail set up and running, head over to vmailmgr.org, grab the latest source tarball, and unpack it into wherever you keep your sources.

vmailmgr currently doesn't have very many compile-time configuration options available, such as switching database backends, etc, so I will not cover those here. I use the standard configure, make, make install to install vmailmgr and it seems to work just fine.

# ./configure
# make
# make install

Once you've completed this, vmailmgr is ready to be implemented into your system!

Configuring password checking for vmailmgr

qmail provides an interface for checking passwords called checkpassword. vmailmgr's checkvpw program is a drop-in, checkpassword-compatible authentication module. In order to authenticate users on a vmailmgr setup, you need to use checkvpw in all places where the checkpassword interface is used. With a LWQ setup, this is the pop3 server. Change /bin/checkpassword in your pop3 run script to /usr/local/bin/checkvpw (note, you may have to change the path based on your ./configure options) and restart your pop3d.

Template:Box File

Personal tools