atlas-os/deploy/README.md
Atlas Developer 8c1efe6e30 feat: Atlas OS v2.0 — space-grade animated README, full productified repo
- 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>
2026-06-22 21:33:18 +02:00

918 B

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

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.