- assets/header.svg: animated SVG header (twinkling stars, orbiting service dots, Atlas A logo with glow, float/pulse animations, corner accents) - README.md: animated banner, full 39-app service catalog, Mermaid architecture, AI stack table, tech stack, quick-deploy, repo structure, security model - ARCHITECTURE.md: one-box philosophy, 5-tier service layers, data flow diagram, Caddy SSO pattern, AI mesh topology, Docker Compose topology - SERVICES.md: all 55 containers + 20 systemd services documented - CHANGELOG.md: full build history from v0.5 to v2.0 - assets/logo.svg: Atlas A logo with gradient - deploy/install.sh: one-command installer (Docker + Caddy + Tailscale + stacks) - deploy/compose/atlas-core.yml: Authentik + Nextcloud + Stalwart + Forgejo + Vaultwarden - deploy/caddy/Caddyfile.template: Authentik SSO pattern, sanitized - deploy/README.md: full deployment guide - server/: sanitized atlas_brain.py, cockpit_shim.py, intelligence.py, meridian.py, atlas_router_api.py, cli-atlas.py (all secrets stripped, env var patterns) - server/systemd/: 6 atlas-* service unit files - server/README.md: deployment and configuration guide Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
32 lines
918 B
Markdown
32 lines
918 B
Markdown
# 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`.
|