Enterprise billing & virtualization management control panel
Aetheris App is the billing core, control panel, hypervisor drivers and client portal rolled into a single monorepo. It converges WHMCS, FOSSBilling, Pterodactyl Panel, Proxmox VE and VirtFusion into one platform.
Strict-mode TypeScript end to end, SOLID modular architecture, SSR-first and zero-layout-shift dark enterprise UI.
| Billing | Hypervisors | Client & Admin | Ops |
|---|---|---|---|
| Unified billing engine | Universal driver contract | Client portal | BullMQ workers |
| Invoices, Subscriptions | Pterodactyl (App + Client) | VNC console (WS) | Provisioning · Billing |
| Proration · Dunning · Tax | Proxmox VE API v2 (QEMU/LXC) | Backups · Power control | Telemetry · Email |
| Stripe / PayPal / Mollie | VirtFusion REST | Admin panel | Webhooks fan-out |
| cPanel/WHM · DirectAdmin | Nodes · Allocations | Encrypted secrets | |
| Nest/Egg targeting | AES-256-GCM credentials | ||
| Whitelabel | Backend API | ||
| Name · Logos · Colors | Python FastAPI | ||
| Email · Custom domain | Auth · Provisioning | ||
| 0 rebuilds — runtime only | Billing callbacks |
flowchart LR
subgraph Clients
Visitor[ Marketing visitor]
ClientUser[ Client portal]
Admin[ Platform admin]
end
subgraph Edge[Vercel Edge]
Site[aetheris-website]
App[aetheris-app web]
end
subgraph Core[Aetheris core]
Billing[ Billing engine]
AdminPlane[ Admin panel]
Workers[ BullMQ workers]
Redis[(Redis)]
Postgres[(PostgreSQL)]
end
subgraph External[Integrations]
Ptero[ Pterodactyl]
PVE[ Proxmox VE]
VF[ VirtFusion]
Pay[ Stripe/PayPal/Mollie]
CF[ Cloudflare]
Reg[ Namecheap]
end
Visitor --> Site
ClientUser --> App
Admin --> App
App --> Billing --> Workers
App --> AdminPlane --> Workers
Workers --> Redis & Postgres
AdminPlane --> Ptero & PVE & VF
Billing --> Pay & Reg & CF
sequenceDiagram
participant C as Client portal
participant A as API layer
participant Q as BullMQ queue
participant W as Provisioning worker
participant D as Hypervisor driver
participant P as Panel/VM
C->>A: POST /api/servers (plan + node)
A->>A: Authorize, validate, create row
A->>Q: enqueue provision job
Q->>W: deliver
W->>D: provision(request)
D->>P: create workload
P-->>D: externalId
D-->>W: ProvisionResult
W->>A: mark installing → running
W->>Q: telemetry + billing start
A-->>C: ServerInfo
cp .env.example .env # fill DATABASE_URL and REDIS_URL
npm install
npx prisma migrate dev
npm run dev # → http://localhost:3000
npm run worker # background queue workersdocker compose up -d --build
# Web UI: http://localhost:3000
# Backend: http://localhost:8000/health
# PG: localhost:5432 · Redis: localhost:6379SQLite mode (no DB container):
docker compose -f docker-compose.sqlite.yml up -d --buildDATABASE_URL=postgresql://aetheris:secret@127.0.0.1:5432/aetheris \
REDIS_URL=redis://127.0.0.1:6379 \
AETHERIS_APP_URL=https://app.example.com \
ADMIN_EMAIL=ops@example.com \
ADMIN_PASSWORD='a-very-long-password' \
bash bin/install.sh --yes --systemd --nginx# Linux / macOS / Git Bash
bash scripts/manage.sh status
bash scripts/manage.sh logs -f
# Windows PowerShell
powershell -ExecutionPolicy Bypass -File scripts\manage.ps1 status
powershell -ExecutionPolicy Bypass -File scripts\manage.ps1 logs -FollowFull walkthroughs in aetheris-docs → Installation
aetheris-app/
├── app/
│ ├── (admin)/ # Admin CP routes
│ ├── (client)/ # Client portal
│ └── api/whitelabel/ # Runtime branding (PG → Redis)
├── backend/ # Python FastAPI + SQLite
├── bin/install.sh # Non-interactive production installer
├── prisma/
│ ├── schema.prisma # PostgreSQL schema
│ └── sqlite/ # SQLite variant + migrations
├── src/
│ ├── lib/
│ │ ├── adapters/
│ │ │ ├── hypervisors/ # Driver contract + backends
│ │ │ └── payments/ # Gateways
│ │ ├── config/env.ts # Zod-validated env
│ │ ├── db.ts / redis.ts / queue.ts
│ │ └── db-codec.ts # SQLite JSON → TEXT codec
│ └── workers/ # Billing · provisioning · telemetry
├── deploy/aetheris.conf # Nginx template (installer)
├── .env.example
└── docker-compose.yml / sqlite variant
| Backend | Interface | Console | Backups |
|---|---|---|---|
| Pterodactyl | Application + Client API | Client API tokens | |
| Proxmox VE | API v2 (QEMU + LXC) | VNC proxy | Snapshots |
| VirtFusion | REST API | Not public | Snapshots |
| cPanel / WHM | JSON API cPanel 2 | N/A | |
| DirectAdmin | Plugin API | N/A |
Driver contract in src/lib/adapters/hypervisors/types.ts.
| Component | Minimum | Notes |
|---|---|---|
| Node.js | 20.x LTS | Requires native fetch · AbortSignal.timeout |
| PostgreSQL | 16 | 15 works; 16 recommended |
| Redis | 7.x | BullMQ requirement; 6.2+ also works |
| Pterodactyl | 1.11+ | App + Client API keys, admin scope |
| Proxmox VE | 7.x / 8.x | API v2 · VM + container perms |
| VirtFusion | 2.x | Bearer token |
| Ubuntu | 22.04 LTS | Debian 12 supported |
Made with care by Leonardo Galli
Docs · Website · Addons · Themes · Game Eggs · Windows Installer · Installer · Ops · Status · Discord · Donate
Aetheris is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). See LICENSE.md.
Any distributed or network-served modified version must keep this license, preserve the copyright notice of the original author (Leonardo Galli / Leo-Galli) and release source code under AGPL-3.0. The Aetheris core and the author's credit may not be removed.
Docs | Website | Addons | Themes | Game Eggs | Installer | Windows Installer | Ops | Status | Community
Copyright (C) 2026 Leonardo Galli (Leo-Galli), Aetheris Project. Licensed under AGPL-3.0.
All contributions require a Pull Request with automated CI checks (lint, typecheck, build) before manual review.
Contact: hello@another-horizon.eu | Discord: discord.gg/6GcfebuT2A