Installation guide

Deploy the Aetheris control panel on Linux, Windows or macOS. The fastest path is Docker — it works identically on every OS.

Estimated time: 15 minutes automated, 60 minutes manual.

Choose your path

Choose your OS

Quick start (Docker)

git clone https://github.com/aetheris-project/aetheris-app.git
cd aetheris-app
cp .env.example .env
docker compose up -d --build

That's it. The stack includes PostgreSQL, Redis, Next.js web, BullMQ worker and the Python backend.

Connecting hypervisors

After deployment, connect your hypervisors in the Admin Panel → Nodes:

1. Add Pterodactyl, Proxmox VE or VirtFusion credentials.
2. Click Synchronize nodes.
3. Assign eggs / templates to billing plans.

Full details: Pterodactyl bridge, Proxmox VE setup, VirtFusion setup.

Verification

curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3000/login
curl -sS http://127.0.0.1:8000/health

See also: System requirements, Environment variables, Troubleshooting.