aetheris-project

One control panel for billing, panels and hypervisors.

Aetheris converges WHMCS, FOSSBilling, Pterodactyl Panel, Proxmox VE and VirtFusion into a single enterprise control panel: one billing engine, one client portal, one set of hypervisor drivers and one admin surface, with dynamic whitelabeling and a theme system that runs across every surface of the platform.

We build with strict-mode TypeScript, token-driven design, zero layout shifts, SSR-first rendering and an English-only, emoji-free standard across code, UI and documentation.

• Unified billing engine: invoices, subscriptions, proration, dunning and tax, wired to Stripe, PayPal and Mollie.
• Universal hypervisor driver contract with native Pterodactyl (Application and Client API), Proxmox VE API v2, VirtFusion REST, cPanel/WHM and DirectAdmin backends.
• Client portal with server lifecycle, VNC console (WebSocket token issuance), backups and payment methods.
• Admin control panel: node management, allocation pools, nest and egg targeting, backup policies and per-client resource limits.
• Dynamic whitelabeling: brand, accent colors, navigation and email templates configured at runtime; dark / light / system themes persisted per visitor.
• Background orchestration with BullMQ: provisioning, billing runs, telemetry and email delivery.
• Self-contained Python backend (FastAPI + SQLite) for demos and development, plus a fully automated installer for Linux, macOS and Windows.
• Ops tooling: a stdlib host scanner that scores the machine, detects optimization opportunities and pending updates, and publishes the results to GitHub as a badge and auto-opened issues.
• A complete theming kit: token reference, templates, ready-made themes and a validator for the dark/light/system design system.

# Automated install on any OS (wizard or non-interactive)
git clone https://github.com/aetheris-project/aetheris-installer.git
cd aetheris-installer
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .
python -m aetheris_installer --yes

# Or run the platform in development
git clone https://github.com/aetheris-project/aetheris-app.git
cd aetheris-app && npm install && npx prisma migrate dev && npm run dev

Full guidance lives in the documentation wiki and the interactive demo.

We welcome contributions across all repositories. Please follow these standards:

• Strict-mode TypeScript; run npm run typecheck before opening a pull request.
• Token-driven design: use the CSS-variable tokens (bg-surface, border-edge, text-muted, accents) instead of hardcoded colors.
• Zero layout shifts: reserve layout space for loading states and toasts.
• English only across code, UI, commit messages and documentation; no emojis.
• Document API changes in the wiki and keep the OpenAPI specification in sync.
• The installer repository is emoji-free by design and writes only inside its target directory.

Open a pull request on the relevant repository. For larger changes, open an issue first to align on the approach.

• Documentation: aetheris-docs
• Interactive demo: aetheris-website
• Support: ops@aetheris.enterprise