Help

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.

  1. First, connect to the server via SSH.
  2. 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

  1. After executing this command, the preparatory phase will begin, and then the system will request confirmation for the installation:

 

Enter "yes" and press "Enter."

  1. 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

Have more questions about Hosting?