Installation Troubleshooting

Most installation problems are related to network connectivity, package management, or attempting to run the install script on an unsupported operating system or architecture.

Installation "Freezes" and Never Completes

Check the virtualmin-install.log. It is likely your package manager is configured to use a local CD ROM device for packages, and the disk is unavailable. Another possibility is that connections to remote package one or more repositories are timing out, and causing the system to install packages very slowly. Finally, on systems that have up2date (RHEL and CentOS versions 3 and 4), you must run up2date once before attempting to install Virtualmin, as it has an interactive configuration step that must be performed manually.

Package Conflicts

If your package manager is configured to use non-OS package repositories, of if you have installed alternative versions of packages before installation, conflicts are likely to occur during installation. If you plan to use non-OS standard packages (other than those provided by Virtualmin repositories), they should be installed after installation of Virtualmin, and you should add an exclude directive to the yum or apt-get configuration in order to insure similar conflicts do not happen in the future.

Also note that if you are using non-OS standard packages, you may need to configure the relevant Webmin module to make it aware of the location of the configuration files.

Getting Help

Virtualmin Professional customers receive free installation service if the automated installation process fails to work correctly on any Grade A or B supported operating system listed on the OS Support page. Open a ticket in the issue tracker with a description of your problem and the relevant portion of the virtualmin-installation.log, and we will try to walk you through to a solution, or log into your system and complete the installation free of charge.

Virtualmin GPL users can make use of the forums to ask for assistance with any problems that arise during installation.