Run Aetheus on your own servers.
Aetheus is a self-hosted infrastructure and CI/CD manager: distributed agents, real deployment pipelines and live dashboards. This documentation explains how the product is put together, and walks through every supported way of installing it.
Install
Three installation routes, from the most manual to the most automated. They lead to the same product; pick the one that matches how you already run services.
Binaries, without Docker
Publish the backend and the frontend as plain files, run them as a systemd unit or a Windows service, next to your own PostgreSQL.
Windows and Linux →Docker
One Compose file brings up the database, the backend and the frontend, with named volumes for everything that must survive an upgrade.
Compose reference →Aetheus pipeline
Let an Aetheus you already run build and deploy the next one, with a minimal build-deploy-release pipeline and no quality gates.
Minimal pipeline →Put it behind a reverse proxy
Aetheus never terminates TLS itself. The backend and the frontend listen on loopback and a reverse proxy publishes them. Apache is the configuration Aetheus runs in production; IIS and nginx are transposed from it and carry an explicit untested badge.
Apache
The reference configuration: two virtual hosts, WebSocket upgrade for the API, and the cache rules a Blazor WebAssembly frontend needs.
Reference config →IIS untested
URL Rewrite and Application Request Routing, WebSocket support, and the MIME types the .NET WebAssembly runtime needs.
Starting point →nginx untested
Two server blocks, connection upgrade for the API, and the same no-store rules on the frontend boot files.
Starting point →Understand how it works
Concepts
Projects, servers and agents, pipelines, runs, releases, artefacts, environments, vaults and variable libraries: the vocabulary the whole product is built on.
Read →Architecture
What each process is, what talks to what, where state lives, and which parts you must back up.
Read →Pipelines
The anatomy of a pipeline YAML: stages, steps, dependencies, variables, templates and native step types.
Read →Elsewhere
- Product website - what Aetheus is and who it is for.
- Live demo - a running instance with a seeded fleet, no installation required.
- Source on GitHub - the code these pages describe, under EUPL-1.2.