Installation guide (ISPmanager)
This article provides information on installing the control panel on your server, including pre-requisites and the stages you should pass, as well as instructions on how to start working in ISPmanager.
Follow the steps below to perform a successful installation of ISPmanager:
Before installing ISPmanager, make sure that the following requirements are met:
Please note! The current version will be installed!
The list of supported operating systems is growing all the time.
We would recommend that you run FreeBSD or Debian Linux, rather than CentOS Linux, CloudLinux in order to ensure the best possible experience with our software. If using other versions, make sure that the distributive includes the required software.
If you run FreeBSD, and your kernel does not support disk quotas and firewall, the Setup Wizard prompts you to download the kernel and reboot the server. We would not recommend partitioning your hard drive, because the limit will be applied only to the partition containing site directories (/home). That's why you must split the disk with one (/).
You will be prompted to install a hostname, if needed.
Disable SELinux, if any, by changing SELINUX=enforcing into SELINUX=disabled in the configuration file /etc/selinux/config, and reboot the system.
All services that ISPmanager requires will be automatically installed during the ISPmanager installation process. You should install a minimal version of the operating system. FreeBSD requires a system without packages; Linux requires the one where Apache/PHP/MySQL-servers are not installed and configured.
If any part of the software is already installed on the server, the Setup Wizard will try to configure it to run with ISPmanager.
You should use public static IP addresses for connections through http (you cannot use NAT).
The license's IP-address must be first on the list of IP-addresses the ifconfig command returns. If not, you can run install.sh with the --ip IP-address key.
Installing the panel
Be sure to obtain the active license for your IP-address. Go to BILLmanager to make sure you are running the active license.
Enter shell on your server and run any of the commands below:
The following are the keys to be used for running the install.sh script command that can be specified in case of problems:
--os OS Provide the operating system manually
--arch ARCH Provide the architecture manually (i386, i686)
--ip IP Provide the IP-address license manually
Welcome to the Setup Wizard
If you are running CentOS, the installation script will enable you to add repositories. CentOS base repositories contains the most stable packages, however a number of packages are not included. To use all the features of the control panel, connect additional repositories:
- Extra Packages for Enterprise Linux (EPEL)
This repository contains additional packages for Enterprise Linux, including Red Hat Enterprise Linux (RHEL), CentOS and Scientific Linux (SL). The control panel uses it to install such packages as PowerDNS, Nginx, MyAdmin, pgAdmin, clamav-milter, etc.
This repository is considered the safest and the most stable. The control panel uses it for installing a number of packages that are also included into the EPEL repository.
The repository is responsible for the latest versions of applications and should be used to enable the DKIM filter in the control panel.
The installation script will prompt you to choose the components you want to install:
- Install most popular software - the most popular software will be installed (such as Apache, PHP (latest versions), Sendmail (Exim for Debian), Dovecot, Proftpd, FastCgi, Bind, MySQL, Webalizer, AwStats, PhpMyAdmin). We recommend that you use this mode for it provides the quickest installation.
- Minimal install (includes web server only) - only Apache will be installed. You will be able to install other software in the Applications module.
- Install all supported software (default for anything) - all components of the panel will be installed. PostgreSQL, PhpPgAdmin, mailing lists will be added to the first mode. You can delete the ones you do not need in the Applications module.
- Gives you a choice of software - only selected components will be installed. Do not choose his mode unless you are an experienced user.
If you choose Gives you a choice of software, you will be prompted to set up the network and system features that you can install on your distribution.
To configure a service, select one you need and click "Enter". Provide the software version that you can use not to install this service.
Note If any of the software versions is already installed on your server, in the Setup Wizard you will see only its version, all other program variants hidden.
Once you have configured software versions, select "Install" and click "Enter". When the installation has been completed, the ISPmanager Setup Wizard will check the installed services and display the results.
If one or more errors occurred during installation, make sure that the package managers on your server are working correctly. For example, if you run FreeBSD, make sure that ports can be downloaded, if you run Debian, check that correct links are specified in /etc/apt/sources.list (apt package manager runs correctly), if running CentOS/Fedora, that the yum package manager is running correctly.
If you want the ISPsystem's administrators to help you install ISPmanager, provide them with the root password to gain access to your server. This user must be able to SSH to the server. To do that, enable the following option in /etc/ssh/sshd_config
Open the URL below in your favourite browser to gain access to ISPmanager. Log in to the control panel using your system users' privileges. Enter the root password and username if you log in to the control panel for the first time
Advanced users can install the software or configure the control panel manually.
More information can be found in the article Technical details.