# PanelAlpha Engine For Docker
This engine has been designed to handle “webhosting service” as a separate docker container on a server. This way each customer’s data is separated and can scale up depending on the needs. The solution also works well for individual customers who are having too large instances to have them on a shared hosting server.
Please note: this setup is now in BETA phase so need to be cautiously implemented on live environments and is recommended only for companies that are familiar with Docker.
# Architecture
Presented below is an illustrative diagram showcasing the architecture of PanelAlpha engine. Explore how the engine is structured and the relationships established between containers.
# Requirements
To successfully install PanelAlpha engine, you must first ensure that your server meets all of the requirements listed below:
- RAM: 4GB
- Operating System:
- Debian 12 "bookworm" or
- Ubuntu 22.04.4 LTS (Jammy Jellyfish)
- SSH Connection with root access
Important!
The PanelAlpha engine must be installed on a separate server, meeting the above requirements. Installing both PanelAlpha and PanelAlpha engine on the same server will cause the installations to be non-functional.
# Installation
The entire installation process is described in the Wizard itself, but you can also refer to this tutorial for additional details.
Start with logging in to your server via SSH using the root account.
Next, Use the below command to download the installer:
wget -N -P /opt/panelalpha https://license.panelalpha.com/engine-installer.sh
Now use the following command to run the script:
bash /opt/panelalpha/engine-installer.sh --key 'LICENSE_KEY'
Don't forget to include the 'key' parameter at the end of the command and paste your license key there. You can locate your license key in your client area under 'Licenses' in the product details.
After the installation is complete, please copy the API Key from the PanelAlpha Engine Installer and paste it in the third step while using the Wizard to install your PanelAlpha platform.
You will also need these data if you decide to add PanelAlpha server type later on, directly in the PanelAlpha Engine platform during further configuration. Proceed to the next step, 'Hosting Server Configuration,' where you will use the data you've just generated.
# Server configuration in PanelAlpha
Hover over Configuration → Servers → Hosting Services. You will see there a list of already installed servers, if there are any. You may add new server from this point, just follow the below steps.
Press the 'Add Server' button, a new form will appear. Fill out all the required data to successfully add the new server:
- Name - enter the server name
- Type - in our case we are selecting "PanelAlpha" engine
- IP/Hostname - enter the same IP/Hostname as you used during the installation process - see step 5 of the PanelAlpha engine installation
- API Token - previously generated API Key - see step 5 of the PanelAlpha engine installation
- SSL Verification - select if you want to connect via SSL
- Test Connection - check if connection is successful
Your PanelAlpha Engine For Docker is now ready to use. You may set it up as Hosting Server type of prepared Plans.
# Redis Cache
- Redis server is automatically installed with each PanelAlpha Engine service as part of the default configuration
- Navigate to the "Plan Configuration" section at: Admin Area → Configuration → Plans → Plan details → Hosting → Enable Redis Cache to enable Redis caching.
- Upon enabling this option, Redis Object Caching (opens new window) plugin will be automatically installed and configured for the WordPress instances.
# Update process
With every new release of the PanelAlpha application, please verify if any changes are introduced to the engine itself. If yes, a manual update will be required. You can find adequate information in the latest PanelAlpha release changelog (opens new window).
Follow the below steps to update the engine:
Access your server using SSH with root privileges.
Download the updater using the below command:
wget -N -P /opt/panelalpha https://license.panelalpha.com/engine-updater.sh
Use the below bash command to execute the script:
bash /opt/panelalpha/engine-updater.sh --key 'LICENSE_KEY'