How to Install Webmin on Your Breeze

How to Install Webmin on Your Breeze

Webmin is a powerful, web-based system administration interface that lets you manage your Breeze instance through an intuitive browser-based GUI. It provides modules for managing users, disk quotas, services, configuration files, package updates, and much more — all without needing to remember complex command-line syntax.

Prerequisites

• A Breeze running Ubuntu 22.04 or later (or Debian 11+)
• Root or sudo access via SSH
• At least 512 MB of free RAM
• A firewall rule allowing port 10000 (Webmin's default port)

Installing Webmin via the Official Repository

Add the Webmin repository and install it with apt:

# Install prerequisites
sudo apt update
sudo apt install -y curl gnupg2

# Add Webmin GPG key and repository
curl -fsSL https://download.webmin.com/jcameron-key.asc | sudo gpg --dearmor -o /usr/share/keyrings/webmin.gpg
echo "deb [signed-by=/usr/share/keyrings/webmin.gpg] https://download.webmin.com/download/repository sarge contrib" | sudo tee /etc/apt/sources.list.d/webmin.list

# Install Webmin
sudo apt update
sudo apt install -y webmin

Accessing the Webmin Interface

After installation, Webmin runs on port 10000 with a self-signed SSL certificate. Open your browser and navigate to:

https://your-breeze-ip:10000

Log in with your system root credentials or any sudo-enabled user account. You may need to accept the self-signed certificate warning on first visit.

Securing Your Installation

Before using Webmin in production, apply these security measures:

• Change the default port: Edit /etc/webmin/miniserv.conf and change port=10000 to a non-standard port
• Restrict access by IP: In Webmin, go to Webmin Configuration > IP Access Control and whitelist only your trusted IPs
• Install a real SSL certificate: Use Let's Encrypt via Webmin's built-in module under Webmin Configuration > SSL Encryption
• Enable two-factor authentication: Go to Webmin Configuration > Two-Factor Authentication and enable TOTP
• Disable root login: Create a dedicated admin user and disable direct root access

Essential Webmin Modules

Webmin organizes functionality into modules. Here are the most useful ones for Breeze administration:

• System > Running Processes: Monitor and manage active processes
• System > Disk and Network Filesystems: Mount and manage storage volumes
• Servers > Apache/Nginx: Configure web server virtual hosts
• Networking > Firewall: Manage iptables or firewalld rules visually
• System > Scheduled Cron Jobs: Create and edit cron jobs through the GUI
• System > Software Package Updates: View and install available system updates

Installing Virtualmin (Optional)

Virtualmin is a Webmin add-on specifically designed for web hosting management. It adds domain, email, database, and DNS management capabilities:

wget https://software.virtualmin.com/gpl/scripts/virtualmin-install.sh
sudo sh virtualmin-install.sh

After installation, Virtualmin appears as a new section in the Webmin sidebar, providing a complete hosting control panel experience.

Updating Webmin

Keep Webmin up to date through the standard package manager:

sudo apt update && sudo apt upgrade webmin -y

You can also update from within the Webmin interface under Webmin Configuration > Upgrade Webmin.