Windows Installer

The official way to run Aetheris on Windows 10/11. It manages Docker Desktop, Git and the full Docker stack.

Repository: https://github.com/aetheris-project/aetheris-windows-installer (opens in a new tab)

Download

curl (Git Bash / WSL / any terminal)

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

Pin a specific version:

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

PowerShell

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

winget (recommended)

winget install AetherisProject.AetherisWindowsInstaller

Winget downloads the installer and its dependencies (Docker Desktop, Git) automatically. You can also browse the latest release (opens in a new tab) on GitHub.

Verify the download with:

certutil -hashfile aetheris-windows-installer.exe SHA256

The published hash lives in the winget manifest (opens in a new tab).

What it does

Feature	Description
Install dependencies	Docker Desktop, Git, Node.js, Python via winget
Install stack	Clone `aetheris-app` + `docker compose up -d --build`
Start / stop	`docker compose up -d` / `docker compose stop`
Status	`docker compose ps` with colored output
Logs	Live `docker compose logs -f` in the TUI
Self-update	Checks GitHub Releases and updates itself
Software update	`docker compose pull` + `up -d`
Uninstall	Stop stack, remove volumes and app directory

Quick links

Setup and wizard — interactive and CLI flow
CLI reference — all flags and examples
Development — build from source, winget packaging