# atlas

> A self-hosted homelab platform: everything that runs on or controls one
> headless home server. A Wake-on-LAN Rust CLI for the Mac, a Rust control-plane
> API with a WebSocket PTY terminal, Postgres 17 + pgvector, a self-built Google
> Photos + Drive replacement with local AI search over photos and video, three
> SwiftUI iOS apps, a music-synced Art-Net -> Philips Hue light-show system, and
> a remote build/dev platform. No cloud, no subscriptions, nothing
> port-forwarded. The box sleeps at ~0 W until you wake it.

Made by Luka Löhr — https://lukaloehr.com

Status: v0.0.1, beta, proof of concept. One person's real homelab published
as-is. It runs daily on the author's hardware; interfaces may change.

    cargo install --path cli
    atlas boot        # Wake-on-LAN, wait for ssh, drop into a shell

## Setup

- [Agent setup runbook](https://atlas.lukaloehr.com/setup.txt): written for a coding agent. Asks first whether the user has a machine at all, then installs only the parts they want. Start here.
- [Upstream setup guide](https://github.com/luka-loehr/atlas/blob/main/docs/SETUP.md): the authoritative from-scratch machine-level guide — hardware, Ubuntu, Tailscale, Wake-on-LAN, CUDA, models, iOS builds.

## Reference

- [Components](https://atlas.lukaloehr.com/components.txt): what each directory is, the CLI verbs, the HTTP services and their ports.
- [Security model](https://atlas.lukaloehr.com/security.txt): what is tailnet-only, what is LAN-only, and the one deliberate internet path.
- [Everything in one file](https://atlas.lukaloehr.com/llms-full.txt): all of the above concatenated.

## Source

- [GitHub repository](https://github.com/luka-loehr/atlas): full source. MIT.

Model weights downloaded at run time keep their own licences, including
InsightFace buffalo_l under a non-commercial research licence.