Launch AitherOS

Bootstrap & setup instructions for humans and agents

Everything you need to go from a fresh clone to a running AitherOS instance. Pick the tab that matches you — Human for interactive setup, or Agent for automated CI/headless bootstrap.

Prerequisites

Make sure you have these before starting

Windows 10/11 (WSL2)or Linux (Ubuntu 22.04+)

Docker Desktop (latest)or Docker Engine on Linux

NVIDIA GPU Driverfor local LLM/Vision — optional but recommended

Node.js 18+ & npmfor AitherVeil dashboard

PowerShell 7+ (pwsh)bootstrap auto-installs if missing

Gitto clone the repository

Step-by-Step Setup

Follow these steps in order

Clone the Repository

Get the source code on your machine

bash

git clone https://github.com/Aitherium/AitherZero.git
cd AitherZero

Run the Bootstrap

One command sets up the entire AitherZero PowerShell module, detects your system, and installs dependencies

powershell

pwsh -File ./bootstrap.ps1 -Mode New -InstallProfile Standard

Install profiles: Minimal Standard Developer Full— use Developer for dev environments.

Run the Guided Installer

Interactive wizard that generates encryption keys, detects hardware, and collects API keys

powershell

pwsh -File ./install-guided.ps1

This creates a .env file with your secrets. AitherSecrets auto-ingests them on first boot.

Start the Core Stack

Launch the core containers for AitherOS-Alpha, including Veil, Genesis, Secrets, and Chronicle

bash

npm start

This starts the default core profile for AitherOS-Alpha.

Open AitherVeil

The dashboard is now running at localhost:3000

Open Dashboardhttp://localhost:3000