Installation Guide
VoidPanel is a powerful, open-source web hosting control panel designed for easy management of your Linux server. This guide walks you through installing and deploying VoidPanel on your server — from prerequisites to your first login.
Server Prerequisites
Before installing VoidPanel, ensure your server meets the minimum requirements. We strongly recommend starting with a clean operating system installation to prevent conflicts with existing services.
| Component | Minimum | Recommended |
|---|---|---|
| OS | Ubuntu 22.04 LTS | Ubuntu 24.04 LTS / AlmaLinux 9+ |
| RAM | 1 GB | 2 GB+ |
| Disk Space | 10 GB | 20 GB+ SSD |
| CPU | 1 vCPU | 2+ vCPUs |
| Network | Static Public IP | Static IP + rDNS configured |
VoidPanel cannot be installed alongside existing web servers (Apache, Nginx) unless they are first removed. Use a freshly provisioned VPS for best results.
First, update your system packages and install curl:
sudo apt update && sudo apt upgrade -y && sudo apt install curl -y
Installation Steps
1. One-Command Quick Install
Run our automated installer script which handles everything: Nginx, Postfix, Dovecot, BIND9, MariaDB, Redis, Celery, and the VoidPanel dashboard itself.
bash <(curl -sL voidpanel.com/install.sh)
- Detects your OS and configures the package manager
- Installs Nginx, MariaDB, Redis, Celery, Postfix, Dovecot, BIND9
- Creates the VoidPanel Django app under
/opt/voidpanel/ - Generates an SSL certificate for your panel domain
- Outputs your Admin URL, Username, and Password at the end
2. Installing as Root
If you encounter permission errors, switch to the root user first:
sudo su -
bash <(curl -sL voidpanel.com/install.sh)
The installation takes approximately 5–15 minutes depending on your server's download speed and CPU performance. Do not interrupt the process.
Troubleshooting
If you encounter problems during installation, check these common causes:
- Unsupported OS: Ensure you are on a clean install of Ubuntu 22.04+. VoidPanel cannot run alongside unconfigured Apache installations.
- Connection Refused: Check your internet connection. Ensure no firewall rules are blocking outbound HTTP/HTTPS (ports 80, 443).
- Out of Memory: You need at least 1 GB RAM. Some modules require compilation which is memory-intensive.
- Port Conflicts: Ensure no other process is listening on ports 80, 443, 25, or 110 before running the installer.
Walkthrough Video
Prefer a visual guide? Watch the step-by-step installation walkthrough: