chaib/atlas-os
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
atlas-os/docs/remote-desktop.md

1.3 KiB
Raw Blame History

Atlas Remote Desktop

A real Linux desktop in the browser — not a web app. Full XFCE on Ubuntu 26.04, streamed via Selkies/WebRTC, where you can run any application: Claude Code, Chromium, a terminal, editors, anything you apt-install.

URL: https://desktop.atlascorporation.nl (login at the Caddy edge)

Why a real desktop

Unlike a headless server, a desktop has a browser — so the Claude Code OAuth login flow works normally. Open the terminal, run claude, log in through Chromium. Done.

Stack

  • Image: lscr.io/linuxserver/webtop:ubuntu-xfce (Selkies/WebRTC)
  • Bind: 127.0.0.1:8131 (loopback only — never exposed directly)
  • Edge: Caddy reverse_proxy + Authentik forward_auth (your atlasshb identity)
  • Persistence: /opt/atlas/webtop/config (home survives restarts)
  • Pre-installed: Claude Code CLI (on PATH), Chromium, XFCE terminal; desktop launchers for Claude + Chromium

Compose

See deploy/webtop-docker-compose.yml. Auth is your Authentik identity (no separate password). Old basic_auth creds in a local .env (gitignored) and the Caddy basic_auth hash — never committed.

Roadmap

  • DONE: edge auth is Authentik SSO (atlasshb identity)
  • Optional: pin Claude to the Max subscription via the in-desktop browser login