Self-hosting
Install the MIT-licensed control panel with the install script or Docker Compose.
Self-hosted Kubeara runs the control panel on infrastructure you control. It is MIT licensed, free forever, with unlimited servers, teams, and members. Workloads still run on the Ubuntu hosts you connect — same model as Cloud.
Source and install script: github.com/kubeara/core.
One-line installer
Review the script before you pipe it to a shell: install.sh.
macOS / Linux / Windows (WSL or Git Bash):
curl -fsSL https://setup.kubeara.dev | shWindows PowerShell (Docker Desktop):
irm https://setup.kubeara.dev/install.ps1 | iexThe installer expects Docker and Compose (it can install Docker Engine on Linux). It writes Compose and env files and starts the panel.
Open the dashboard at http://your-server-ip:3000 or the port printed in the installer output.
Manual Docker Compose
git clone https://github.com/kubeara/core
cd control-panel
cp .env.example .env
docker compose up -dEdit .env for secrets, public URL, and ports before you expose the panel beyond localhost.
After the panel is up
- Complete first-run account setup in the UI.
- Connect an Ubuntu 22.04+ server over SSH.
- Deploy a catalog service.
The panel host and the workload servers can be the same machine or different machines. Treat the panel like production: TLS in front of it, backups of its database/volumes, and restricted SSH.
Updates
Pull newer images or re-run the installer channel you use (KUBEARA_VERSION / docs on GitHub). Always snapshot volumes before a major upgrade.
When to use Cloud instead
Use Kubeara Cloud if you do not want to operate the panel, or you want the free 1-server Cloud tier without running Compose. Workloads still stay on your servers.