This tutorial will walk you through the installation of VirtualMin on a CentOS 5.2 server.

This tutorial assumes the following:

• You have gone through the CentOS - Setup article
• You are running as a normal user with privileged access (sudo).
• This installation MUST be performed on a server that has nothing else installed. If you have already begun installing software please use the Rebuild function in the Control Panel.
• Be sure that DNS is fully setup for your Cloud Server as well.
• You are running on a 1GB (1024MB) or higher Cloud Server. Smaller servers will work but you will not be able to use all of the features.

Update System

First we will update the system to ensure that we have all of the latest software installed.

# sudo yum -y update

Install pre-requisites

We need to install a few things before VirtualMin will install. Type the following:

# sudo yum -y install perl

Download VirtualMin Installer

Now we need to download the VirtualMin installer. Type the following to download it:

 # wget http://software.virtualmin.com/gpl/scripts/install.sh

Installation

Now it is time to install VirtualMin. To do so, use the command below:

# sudo sh install.sh

You will be prompted with a license agreement. Press Y followed by Enter to continue.

It will begin performing several checks and installing the required components.

Once it has completed you should see a line similar to the following:

ssapi mod_ssl ruby ruby-devel rubygems perl-XML-Simple perl-Crypt-SSLeay: Succeeded.

Logging In

You are now ready to log into your VirtualMin console. To do this point your web browser to https://12.34.56.78:10000/ where you will be prompted with a login screen (be sure to change 12.34.56.78 to your server's IP). On your first login use the username root and type in your root password.

Post Setup Wizard

Once you login you will be prompted with a Post Setup Wizard. Click Next.

You will be prompted if you would like to pre-load certain libraries. Click Yes and then Next.

You will be prompted if you would like to run ClamAV virus scanner on your server. It is suggested that you select Yes and press Next.

You will be prompted if you would like to run the SpamAssassin e-mail spam scanner. If you are not running e-mail services it is not necessary to run this. However if you are hosting e-mail it is highly advised. Press Yes and Next if you are going to use SpamAssassin, otherwise click Next.

Next you will be prompted if you would like to run MySQL and/or PostgreSQL servers. This is entirely up to you as to which database servers you will provide to your customers (if any). Select your options and press Next. You will be prompted on the following screens for password information.

Once finished you will be presented with an 'All Done' page. Click Next.

Once the main page loads you will need to reload your configuration. Click the 'Re-check and refresh configuration' button in the yellow box.

--Kelly Koehn 13:58, 5 June 2009 (CDT)