Installation Guide
VoidPanel is a powerful control panel designed for easy management of your Linux servers without the complexity of traditional enterprise solutions. This documentation outlines the steps to install and deploy VoidPanel on your system.
Prerequisites
Before installing VoidPanel, ensure your server meets the minimum requirements. We highly recommend proceeding with a clean operating system installation to prevent conflicts.
- Operating System: Ubuntu 22.04 LTS (Recommended) or AlmaLinux 8
- RAM: 1 GB Minimum (2 GB+ Recommended)
- Disk Space: 10 GB Minimum
- CPU: 1 Core Minimum
- Network: Static Public IP Address
First, update your system packages and install `curl` to fetch the installation script:
sudo apt update && sudo apt install curl -y
Installation Steps
1. The Quick Install Command
You can run our automated script which will handle installing Nginx, Postfix, Dovecot, BIND, MariaDB, and the complete VoidPanel dashboard.
Simply open your terminal and run:
curl -fsSL https://voidpanel.com/op/install.sh | bash
2. Installing with Root Privileges
If you encounter any permissions errors during the initialization step, you may need to switch to the root user before running the command.
sudo su
curl -fsSL https://voidpanel.com/op/install.sh | bash
- Ensure your user has the necessary permissions to execute commands with sudo.
- The installation may take 5–10 minutes depending on your server's download speed. Do not interrupt the process.
- Once completed, the script will output your Admin URL, Username, and Password on the console.
Troubleshooting
If you run into problems during the installation process, check the following common issues:
- Unsupported OS: If you encounter dependency issues, ensure that you are using a clean install of Ubuntu 22.04 or higher. VoidPanel cannot be run alongside existing web servers (like Apache) unconfigured.
- Connection Refused: Check your internet connection if the command fails to download the script. Ensure no firewall rules are blocking outbound HTTP/HTTPS.
- Out of Memory: Make sure you have sufficient system resources. 1GB RAM is heavily required during the compilation of some modules.
Walkthrough Video
Prefer a visual guide? Watch our step-by-step installation walkthrough to see exactly how to setup your server from start to finish.