Virtualmin Manual Installation HOWTO

This legacy document is here only to insure incoming links continue to work. You likely want to start with the new documentation index or search for what you want to know about. This document is unmaintained!

There is a new version of this document..

Legacy Virtualmin Manual Installation HOWTO

Table of Contents

    This legacy document is here only to insure incoming links continue to work. You likely want to start with the new documentation index or search for what you want to know about. This document is unmaintained!

    There is a new version of this document..

    Legacy Virtualmin Manual Installation HOWTO

    Table of Contents

    FIXME: Note that this document is currently incomplete, and is posted only for reference. Questions are welcome in the forums, however.

    Manual Installation

    Virtualmin Professional and Virtualmin GPL offer an automated installation script and pre-built software for all necessary components on a limited number of Operating Systems. If you cannot use one of the supported platforms, or if you need to install Virtualmin on a an existing production system, a manual installation may be necessary.

    The process is long and has many steps, but it is not difficult for system administrators with moderate proficiency with the target OS.

    The first part of the process is installing all of the necessary dependencies.

    The second part is installation of Webmin, Usermin, and the Virtualmin Professional or Virtualmin GPL components.

    The third and final part is configuring the components for use with Virtualmin.

    Dependencies

    A complete Virtualmin system includes the following software packages, in reasonably modern versions. Newer is better, but use the version provided by your OS vendor whenever possible to ease administration and maintenance and improve security and stability.

    Required Components

    Apache 2.0 or 2.2 with a minimum of the following modules

    • mod_fcgid
    • mod_suexec with recommended docroot /home (this is not the default on any OS, so a custom build is always required, unless you can use one of our packages)

    Postfix

    Dovecot 1.0rc6 or higher

    Procmail with delivery to $HOME/Maildir

    BIND

    ProFTPd

    Optional Components (for use with Install Scripts)

    MySQL 4 or 5

    PostgreSQL

    PHP 4 and/or 5 and Pear

    Perl

    Ruby 1.8.4 or higher and Ruby Gems

    Optional Plug-ins and Reporting

    Webalizer

    AWStats

    Subversion

    mod_perl 2.x (for Analytics plug-ins)

    Install Webmin, Usermin, and Virtualmin modules

    After getting all of the above dependencies installed, it's useful to install Webmin and Usermin and the Virtualmin modules (though the Virtualmin modules won't be useful until you've configured the above components, you can use Webmin to assist with those steps).

    Download the latest version of Webmin and Usermin from http://www.webmin.com, preferably from the native package used by your OS, but if your OS does not support packages, the tar.gz package will also work (it will just require more human interaction).

    Installation of Webmin and Usermin is already covered in the Webmin documentation, so I won't discuss it here. The Webmin download and installation documentation can be found here:

    http://www.webmin.com/download.html

    Likewise for Usermin:

    http://www.webmin.com/usermin.html

    The Virtualmin module, and optionally it's plug-in modules for reporting and Subversion and other databases and FTP servers, can be found either in the Virtualmin.com software repositories or at http://www.webmin.com/virtualmin.html, depending on whether you have purchased the Professional version. Note that the GPL and Professional versions are similar, but not identical. The Professional versions include features not offered by the GPL version, so if you wish to use the Professional features, you must download from Virtualmin.com.

    These modules can then be installed using the Webmin:Webmin Configuration:Webmin Modules page in Webmin. Virtualmin Professional users may also choose to use yum, urpmi, yast, or apt-get to obtain the packages, and automatically resolve dependencies. This option is available even if you do not use our automated installation, and it can ease the installation process to some degree.