How to Install ISPConfig on Ubuntu

How to Install ISPConfig on Ubuntu

ISPConfig is a free, open-source hosting control panel that provides a comprehensive web interface for managing web servers, email servers, DNS, databases, and FTP accounts. It supports multiple servers from a single panel, making it a strong choice for hosting environments running on your Breeze. This guide walks you through a full installation on Ubuntu 22.04 LTS.

Prerequisites

• A Breeze instance running Ubuntu 22.04 LTS (clean install recommended)
• A fully qualified domain name (FQDN) pointed to your Breeze IP
• At least 2 GB RAM and 20 GB disk space
• Root SSH access

Setting the Hostname

ISPConfig requires a valid FQDN. Configure it before installation:

sudo hostnamectl set-hostname server1.example.com
echo "your-breeze-ip server1.example.com server1" | sudo tee -a /etc/hosts

Verify with hostname -f — it should return the full FQDN.

Using the Auto-Installer

ISPConfig provides an automatic installer that handles all dependencies:

# Download the auto-installer
wget -O /tmp/ispconfig-ai.sh https://get.ispconfig.org
chmod +x /tmp/ispconfig-ai.sh

# Run the installer (interactive)
sudo /tmp/ispconfig-ai.sh

The installer will prompt you for several choices:

• Web server: Choose Apache or Nginx
• Database: MariaDB is recommended
• Mail server: Postfix with Dovecot
• DNS: BIND9 for local DNS management
• FTP: PureFTPd
• Firewall: Bastille or UFW integration

What Gets Installed

The auto-installer configures a complete LAMP/LEMP stack along with supporting services:

• Apache2 or Nginx with PHP-FPM (multiple PHP versions)
• MariaDB with phpMyAdmin
• Postfix, Dovecot, SpamAssassin, ClamAV for email
• BIND9 for DNS hosting
• PureFTPd for FTP access
• Let's Encrypt integration for automatic SSL certificates
• Fail2Ban for intrusion prevention

Accessing the ISPConfig Panel

After installation completes, access the control panel at:

https://server1.example.com:8080

Default login credentials are displayed at the end of installation. Change the admin password immediately after your first login under System > CP Users.

Post-Installation Configuration

SSL for the Panel Itself

# Generate a Let's Encrypt certificate for the panel
sudo certbot certonly --standalone -d server1.example.com
# ISPConfig will detect and use the certificate automatically

Creating Your First Website

• Navigate to Sites > Add new Website
• Enter the domain name, select the PHP version, and set the document root
• Enable Let's Encrypt SSL from the SSL tab
• Create associated email mailboxes under Email > Mailbox
• Add databases under Sites > Databases

Multi-Server Setup

ISPConfig supports a multi-server architecture where one master panel controls multiple slave servers. This is ideal for distributing web, mail, and DNS across separate Breeze instances for better performance and reliability. Configure slave servers under System > Server Config in the ISPConfig panel.

Keeping ISPConfig Updated

# Update ISPConfig to the latest version
cd /tmp
wget https://www.ispconfig.org/downloads/ISPConfig-3-stable.tar.gz
tar xzf ISPConfig-3-stable.tar.gz
cd ispconfig3_install/install/
sudo php -q update.php