# Deploy

One-command installer for Atlas OS on a fresh Debian 12 / Ubuntu 24.04 server.

## Prerequisites

- Debian 12 or Ubuntu 24.04 (x86_64)
- Root access
- A domain with DNS pointed at the server
- A Tailscale account (free tier works)

## Install

```bash
git clone https://git.atlascorporation.nl/chaib/atlas-os
cd atlas-os
chmod +x deploy/install.sh
sudo ./deploy/install.sh --domain yourdomain.com --email admin@yourdomain.com
```

## Post-install

1. Open `https://auth.yourdomain.com` and complete Authentik setup
2. Create your admin user in Authentik
3. Open `https://command.yourdomain.com/os/` — Atlas OS desktop boots
4. Add the AI stack: `docker compose -f deploy/compose/atlas-ai.yml up -d`
5. Configure `server/atlas_brain.py` with your mail accounts

## Secrets

The installer generates strong secrets at `/opt/atlas/secrets/atlas.env` (chmod 600).
Never commit this file. It is in `.gitignore`.