Aetheris — Windows Installer

Interactive TUI installer for the Aetheris control panel on Windows

App | Docs | Website | Addons | Themes | Game Eggs | Windows Installer | Installer | Ops | Status | Android Discord | Donate

---

Interactive installer for the Aetheris billing & virtualization control panel on Windows 10/11 64-bit. The platform runs as a Docker stack (web, worker, backend, PostgreSQL, Redis). This installer manages the environment around it: installing dependencies via winget, cloning and starting the stack, managing it from a live TUI menu — or tearing it cleanly back down.

Features

Interactive TUI wizard Arrow-key navigation · Space toggles · Enter confirms Box-drawing frames · brand accent colors · live spinner Emoji-free by design Falls back to plain prompts when windows-curses is unavailable	Dependency management Installs Docker Desktop, Git for Windows via winget Optional: Node.js LTS · Python 3.12 Dependencies toggled in the wizard or CLI
Full stack deployment Clones aetheris-app into your chosen directory Runs docker compose up -d --build Choose PostgreSQL container or local SQLite .db Decide when .env is written: now or later (manual)	Lifecycle control Uninstall: docker compose down -v + remove directory Dry-run: preview every command, execute nothing Manage menu: status · start · stop · live logs viewer Auto-updater: checks GitHub Releases on launch

Requirements

Component	Minimum
OS	Windows 10 / 11 — 64-bit
RAM	4 GB or more (Docker Desktop)
Disk	10 GB free recommended
Architecture	x86-64 · ARM64 via emulation

Download

Method 1 — winget (recommended, auto-updates)

winget install AetherisProject.AetherisWindowsInstaller

Winget installs Docker Desktop and Git for Windows automatically as declared dependencies.

Method 2 — curl (CMD / PowerShell / Git Bash)

curl -L -o aetheris-windows-installer.exe ^
 https://github.com/aetheris-project/aetheris-windows-installer/releases/latest/download/aetheris-windows-installer.exe

Method 3 — PowerShell Invoke-WebRequest

Invoke-WebRequest -Uri https://github.com/aetheris-project/aetheris-windows-installer/releases/latest/download/aetheris-windows-installer.exe -OutFile aetheris-windows-installer.exe

Verify (optional)

certutil -hashfile aetheris-windows-installer.exe SHA256

Compare with the hash in the winget manifest.

Usage

Interactive (double-click the .exe)

aetheris-windows-installer

• ↑↓ / jk — navigate
• Space — toggle dependency checkboxes
• Enter — confirm
• Esc — go back one step
• q — quit

Command line

# Only install dependencies (Docker Desktop + Git)
aetheris-windows-installer --deps

# Only deploy the software stack
aetheris-windows-installer --software

# Install everything
aetheris-windows-installer --both

# Uninstall (stops stack + removes directory)
aetheris-windows-installer --uninstall

# Custom target directory (default: %USERPROFILE%\aetheris)
aetheris-windows-installer --both --dir "D:\Aetheris"

# Use local SQLite .db instead of the PostgreSQL container
aetheris-windows-installer --both --db sqlite

# Skip writing the .env file (you will create it manually)
aetheris-windows-installer --software --no-env

# Preview actions without executing anything
aetheris-windows-installer --both --dry-run

From source

python -m venv .venv
.venv\Scripts\activate
pip install -e ".[tui,dev]"
python -m aetheris_wininstaller

The TUI requires windows-curses; it's pulled in via the tui extra and bundled into the standalone executable by tools/build_exe.py.

Installed Dependencies

Dependency	winget ID	Required
Docker Desktop	Docker.DockerDesktop	Yes
Git for Windows	Git.Git	Yes
Node.js LTS	OpenJS.NodeJS.LTS	Optional
Python 3.12	Python.Python.3.12	Optional

Docker and Git are always required and cannot be deselected. Optional dependencies are toggled in the wizard or via CLI flags.

After Installation

The stack is up at:

• Web UI: http://localhost:3000
• Backend health: http://localhost:8000/health

Two database modes are supported:

Mode	What happens
PostgreSQL (default)	Starts a PostgreSQL container. A random POSTGRES_PASSWORD is generated.
SQLite (recommended for tests)	No DB container. Uses docker-compose.sqlite.yml and stores data in a local .db file. The installer sets AETHERIS_DB_MODE=sqlite for you.

The project lives in the directory you chose (default %USERPROFILE%\aetheris) under aetheris-app. A random AETHERIS_SECRET is generated on first install.

---

Made with care by Leonardo Galli

Cross-platform installer · App · Docs · Discord · Donate

License

Licensed under GNU Affero General Public License v3.0 (AGPL-3.0). See LICENSE.md.

---

App | 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}