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.