3 Deploy

chaib edited this page 2026-06-22 20:29:15 +00:00

Table of Contents

• Deploy
• Prerequisites
• Install
• Post-install
• Secrets

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.

Atlas OS

Get started

• Home
• Get Started
• Pricing
• For SMEs

Technical docs

• Architecture
• Services
• AI Stack
• Deploy
• Security
• Remote Desktop
• Fleet and Mesh
• App Catalog

Platform

• Academy
• Islamic Layer