OwnLLM Docs
Desktop app

Overview

Atlas — the OwnLLM native desktop app. Pair, manage models, and supervise the agent from a system tray icon.

Atlas is the OwnLLM desktop app: a Tauri-based native client for macOS, Windows, and Linux. It bundles everything needed to serve inference (the OwnLLM agent, Ollama, cloudflared) and exposes a small GUI on top — pairing wizard, model manager, dashboard, tray icon.

If you'd rather have no GUI (servers, VPS, headless boxes), use the CLI instead. The two pair to the same OwnLLM tenant — pick whichever fits the host.

What Atlas does

  • Pairs the host to your OwnLLM tenant via a one-shot key.
  • Supervises the runtimes (Ollama, cloudflared) so the agent restarts on crash and updates atomically.
  • Manages models — install / remove / configure from a UI on top of Ollama.
  • Stays out of the way — after pairing, Atlas lives in the system tray. Click for status, right-click for the dashboard or quit.

Install

See Install / Desktop app.

OS support

OSStatusBundle
macOS 13+ (arm64 / x86_64)Supported.dmg (signed, notarized)
Windows 10 / 11 (x86_64 / arm64)Supported.msi (signed)
Ubuntu 22.04+ / Fedora 40+Supported.deb / .rpm / .AppImage
Older / niche distrosBest-effort.AppImage works in most cases

Atlas does not run on iOS, iPadOS, Android, or in a browser. The /chat web app on <your-slug>.ownllm.app is the mobile/browser surface — Atlas is the agent, not the chat client.

Tray icon

After pairing, Atlas hides its main window and shows a tray icon:

IconMeaning
GreenOnline, tunnel up, gateway healthy
YellowDegraded — one runtime down or heartbeat lagging
RedOffline — daemon stopped or unable to reach OwnLLM

Click the tray icon to expose status, Open Atlas (full dashboard), and Quit.

Auto-update

Atlas uses Tauri's signed updater. Updates download in the background, verify their signature, and apply at the next app start. You can pick Stable or Beta in Settings.

Logs

The same log layout as the CLI — ~/Library/Application Support/ownllm/logs/ (macOS), %LOCALAPPDATA%\ownllm\logs\ (Windows), or ~/.local/state/ownllm/logs/ (Linux). The Dashboard shows the last 50 lines inline; for full logs use a terminal.

Next

  • Pairing — first-run wizard.
  • Dashboard — what each panel does.
  • Models — install / configure from the UI.
  • Settings — autostart, channel, updater.

On this page