# Installation
This guide walks you through installing PanelAlpha Engine on your server.
# Before You Begin
- Ensure that your server meets all system requirements.
- Make sure you have root access to your server via SSH.
- Have your PanelAlpha license key ready. You can find it in your client area under Licenses (opens new window), in the product details.
- Ensure your server has internet connectivity to download the installation files.
# Download and Install
The installation process is described in detail in the Wizard itself, but you can also refer to this tutorial for additional guidance.
Log in to your server via SSH as root:
ssh root@your-server-ipDownload the installer:
wget -N -P /opt/panelalpha https://license.panelalpha.com/engine-installer.shRun the installation script with your license key:
bash /opt/panelalpha/engine-installer.sh --key 'YOUR_LICENSE_KEY'Important: Replace
YOUR_LICENSE_KEYwith your actual license key from the client area.Wait for the installation to complete and copy the API key from the PanelAlpha Engine Installer output.
Save the API key — you will need to paste it in step three of the PanelAlpha installation wizard.
# Connect Through the PanelAlpha Installation Wizard
If you are installing PanelAlpha and PanelAlpha Engine together, you can attach the engine while completing the product wizard (Step 3 — Add your first server).
- Select PanelAlpha Engine as the server type and confirm the prerequisites (Debian 12/13 or Ubuntu 22.04.4/24.04 LTS, 4 GB RAM, root SSH access).
- Click Install PanelAlpha Engine to view the installer command (it matches the steps above) and run it on your dedicated server.
- When the installer returns the API Token, paste it along with the IP/Hostname into the wizard.
- (Optional) Enable SSL Verification, run Test Connection, and click Continue to finish the wizard step.
# Next Steps
After completing the installation:
- Configure the server — add the server to PanelAlpha.
- Configure the plan — set up plan details for the server.
# Troubleshooting
If you encounter any issues during installation, refer to our Troubleshooting Center for detailed solutions.