Downloading and Installing

A tar/gzip archive containing the current Usermin distribution is available for download from:

Unix tar/gzip format
http://prdownloads.sourceforge.net/webadmin/usermin-1.620.tar.gz 6.1 MB

RPM suitable for Redhat, Fedora, CentOS, SuSE or Mandrake Linux
http://prdownloads.sourceforge.net/webadmin/usermin-1.620-1.noarch.rpm 6.6 MB

Source RPM suitable for Redhat, Fedora, CentOS SuSE or Mandrake Linux
http://prdownloads.sourceforge.net/webadmin/usermin-1.620-1.src.rpm 6.1 MB

Debian package suitable for Debian, Ubuntu or other derived Linux
http://prdownloads.sourceforge.net/webadmin/usermin_1.620_all.deb 6.1 MB

You can also download recent versions of Usermin. You can also view the change log for a list of new features in this version and older releases.

If you just want to use Usermin for webmail with an existing IMAP server, special Usermin packages are available that have been pre-modded with a theme and default configuration for this purpose.

The PGP key that the RPM packages for versions 0.970 and above were signed with is also available, so that you can verify their integrity. Just add it to your GnuPG or PGP keyring and run the command rpm --checksig usermin-1.620-1.noarch.rpm. If you are using RPM version 4 or above, you will need to import the key into RPM's key database with the commands : wget http://www.webmin.com/jcameron-key.asc
rpm --import jcameron-key.asc

The PGP signature for the latest tar/gzip version of Usermin is also available so that you can verify the tar.gz file with the command gpg --verify usermin-1.620.tar.gz-sig.asc usermin-1.620.tar.gz.

MD5 Verification

To verify that you have downloaded Usermin fully and correctly, you can use the command md5sum on the RPM, Debian package or TAR file, and compare it against those listed below :

Filename MD5 Checksum
usermin_1.620_all.deb d1b1c0c6bf9ca443af34bb5a310bb129
usermin-1.620-1.noarch.rpm ebf49cf648bb633fb93a976ce941c647
usermin-1.620-1.src.rpm 0848e5c8ce938e5eccb0da7b5602aff8
usermin-1.620.tar.gz 68fb3f183fa67eccf0a8872892db1899

Requirements

Because it allows logins by any Unix user on your system, Usermin needs some way of checking user passwords. By default, this will be done by just reading the /etc/shadow file directly, but if your system uses NIS this will not work.

Instead, you will need to install the Authen::PAM perl module. This module can be installed using Webmin's Perl Modules module, or manually downloaded from CPAN. For this module to compile, you must have the PAM header files installed on your system. On some Linux distributions they can be found in the pam-devel package, which may not be installed by default.

In addition, Usermin requires that a PAM service called usermin be created. On Linux, this typically involves creating the file /etc/pam.d/usermin containing : #%PAM-1.0
auth required pam_unix.so shadow nullok
account required pam_unix.so
password required pam_unix.so shadow nullok use_authtok
session required pam_unix.so

However, if you install the RPM version this file will be created for you automatically.

Under OSX, the PAM service file apparently has to be slightly different. If you are running MacOS X, /etc/pam.d/usermin should instead contain : # login: auth account password session
auth sufficient pam_securityserver.so
auth required pam_deny.so
account required pam_permit.so
password required pam_deny.so
session required pam_permit.so

On FreeBSD and Solaris, you probably will not need to edit the PAM config file /etc/pam.conf as it is setup to do Unix authentication for unknown services by default.

Latest Version Links

If you want a URL that always downloads the latest version of Usermin, you can use one of the following :

Unix tar/gzip format
http://www.webmin.com/download/usermin-current.tar.gz

RPM suitable for Redhat, Fedora, CentOS, SuSE or Mandrake Linux
http://www.webmin.com/download/rpm/usermin-current.rpm

Debian package suitable for Debian, Ubuntu or other derived Linux
http://www.webmin.com/download/deb/usermin-current.deb