If you have a fresh system running CentOS 5 or Debian 4.0 and want to install the full Virtualmin GPL stack (including Webmin, Apache, Postfix and other dependencies), the easiest way is to use the Virtualmin GPL install script. Otherwise, you should add it to an existing Webmin install, as described here.
First download the Virtualmin module in the format that matches your Webmin install :
Virtualmin module in RPM format (for Redhat or Fedora Linux) :
http://download.webmin.com/download/virtualmin/wbm-virtual-server-5.02.gpl-1.noarch.rpm (1.3 MB)
Virtualmin module in Debian Package format (for Debian and Ubuntu Linux) :
http://download.webmin.com/download/virtualmin/webmin-virtual-server_5.02.gpl_all.deb (1.3 MB)
Virtualmin module in Webmin format (for FreeBSD, MacOS and Solaris) :
http://download.webmin.com/download/virtualmin/virtual-server-5.02.gpl.wbm.gz (1.3 MB)
You should also install the Virtualmin theme, again in the appropriate format for your operating system :
Virtualmin theme in RPM format (for Redhat or Fedora Linux):
http://download.webmin.com/download/virtualmin/wbt-virtual-server-theme-9.2-1.noarch.rpm (2.3 MB)
Virtualmin theme in Debian Package format (for Debian or Ubuntu Linux):
http://download.webmin.com/download/virtualmin/webmin-virtual-server-theme_9.2_all.deb (2.2 MB)
Virtualmin theme in Webmin format (for FreeBSD, MacOS and Solaris):
http://download.webmin.com/download/virtualmin/virtual-server-theme-9.2.wbt.gz (2.2 MB)
You can install the module by going to the Webmin Configuration module, clicking on Webmin Modules and use the first form on the page to install the downloaded file. Or install it directly from the above URL. After installation the module will show up in the Servers category.
To install the theme, go to the Webmin Configuration module, click on Webmin Themes and install the downloaded file. Once this is done, you should use the Webmin Themes page to make the new theme the default, if your system is to be primarily used for virtual hosting.
The same theme file can be used with Usermin too, to provide a similar user interface style and a better framed interface for reading email. To install it, go the Usermin Configuration module, click on Usermin Themes and install from the .wbt.gz file.
If you are interested, older versions of Virtualmin are also available.
Virtualmin versions 2.30 and above support plugins, which are Webmin modules that provide additional virtual server or mailbox user features. Some existing plugins are available here.
Setting up Virtualmin Manually
To work properly, Virtualmin requires that several servers like Apache, Postfix
and BIND be configured and running, and that their corresponding Webmin modules
be setup too. To do this, you can follow the basic steps below :
- Install Webmin, if you don't already have it. If so, make sure it is upgraded to the latest version.
- Visit Webmin's modules for Apache, BIND, Postfix and MySQL to ensure that all those servers are installed and running. If you prefer Sendmail, it may be used instead of Postfix.
- Go to the Webmin Configuration module and click on Webmin Modules. Then install both the virtual-server....wbm.gz and virtual-server-theme....wbt.gz files linked above.
- In the Webmin Configuration module, click on Webmin Themes and select the Virtualmin Framed Theme.
- Logout of Webmin and log back in again - you should see the new Virtualmin framed user interface.
- Click the button labelled Re-check and refresh configuration. This will list any problems found on your system, such as missing or im-properly configured servers.
- Fix all the problems, and re-try clicking the button. Repeat this until no problems are found.
- Click the Create virtual server link on the left menu to add your first domain.
If you installed using the Virtualmin install script, all of these steps are automated for you. But that is only suitable for systems not currently hosting any websites or DNS domains.