ISPConfig Installation: Steps and Instructions
Before beginning the panel installation, you can familiarize yourself with its interface and functionality in the demo version on the ISPConfig website.
ISPConfig can be installed on servers running the following operating systems:
- Debian 9, 10
- Ubuntu 16.04 - 20.04
- CentOS 7, 8
The installation should be performed on a clean server without prior configuration.
- First, connect to the server via SSH.
- Next, use the following command to download and run the installer, which will install the standard software stack: Apache2, PHP (versions 5.6 - 8.0), MariaDB, Postfix, Dovecot, Rspamd, BIND, Jailkit, Roundcube, PHPMyAdmin, Mailman, Webalizer, AWStats, and GoAccess.
wget -O - https://get.ispconfig.org | sh -s --
If you want to make changes to the installation, you can customize the command by adding the necessary parameters.
For example, to install Nginx instead of Apache2 as the web server, use the following command:
wget -O - https://get.ispconfig.org | sh -s -- --use-nginx
For most cases, if you are unsure which option to choose, it is recommended to use the standard installation command to get all the necessary software on your server.
However, if you need to customize the installation to your preferences, here are the available parameters for customization:
--help |
Show instructions on how to use this command |
--debug |
Activate debugging during the installation process |
--channel |
Choose the ISPConfig version to install Format: --channel=<stable|dev> stable - the latest stable release, recommended for regular users; dev - the latest release from the Git repository, may contain bugs and untested features, recommended for experienced users. |
--lang |
Choose the language for the installer (English and German available). Format: --lang=en|de |
--use-nginx |
Install Nginx as the web server instead of Apache2 |
--use-amavis |
Use Amavis instead of Rspamd for mail filtering |
--use-unbound |
Install Unbound instead of Bind9 as the local DNS. Do not use this parameter if --no-dns is set |
--use-php |
Install only the specified PHP versions (by default, all are installed). Available versions: 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0. For example: --use-php=7.4,8.0 |
--use-php=system |
Disable the installation of additional PHP versions from third-party repositories and install only the version from the official repository |
--use-ftp-ports |
Set a range of ports for FTP in passive mode. For example: --use-ftp-ports=40110-40210 |
--no-web |
Do not use ISPConfig to manage the web server configuration. This parameter also disables the installation of Nginx/Apache, PureFTPd, Roundcube, and PHPMyAdmin |
--no-mail |
Do not install a mail server. Only Postfix will be installed for sending system notifications |
--no-dns |
Do not install a DNS server. Bind will be installed only for the system |
--no-local-dns |
Do not use a local DNS cache |
--no-firewall |
Do not install UFW (Uncomplicated Firewall) |
--no-roundcube |
Do not install Roundcube Webmail |
--roundcube |
Install Roundcube even if --no-mail is used (manual configuration is required) |
--no-pma |
Do not install PHPMyAdmin |
--no-mailman |
Do not install Mailman |
--no-quota |
Disable quotas |
--no-ntp |
Do not configure system time synchronization |
--unattended-upgrades |
Enable automatic updates You can also add the following parameters: --unattended-upgrades=autoclean,reboot - for automatic cleaning and rebooting --i-know-what-i-am-doing - for installation without confirmation |
- After executing this command, the preparatory phase will begin, and then the system will request confirmation for the installation:
Enter "yes" and press "Enter."
- Wait for the installation process to complete. After it finishes, you will see a message similar to this:
The panel has been successfully installed. To access it, go to the following address: https://IP_server_address:8080/login/
Use the login credentials provided during the installation: username "admin" and the password from the "Your ISPConfig admin password is" line.
After completing the panel installation, it is recommended to execute the following command to ensure the proper functioning of the Roundcube Webmail email client in the future:
chown -Rf ispapps:www-data /etc/roundcube