OwnLLM Docs
Desktop app

Settings

Atlas settings — autostart, update channel, log level, account.

Open Settings from the tray menu or the dashboard's bottom bar.

General

  • Start at login — registers Atlas with the OS service manager so the agent comes back after a reboot. On by default; turn it off to manage Atlas yourself.
  • Show in Dock / Taskbar — Atlas can hide from the Dock (macOS) or the taskbar (Windows / Linux) and live only in the system tray.
  • Theme — Light, Dark, or follow system. Changes the dashboard's appearance only; the public chat at <your-slug>.ownllm.app has its own theme.

Updates

  • Channelstable (default) or beta. Beta gets each release ~7 days before stable.
  • Auto-install — when on, Atlas downloads, verifies, and applies updates in the background; the new version takes effect at the next app start. When off, Atlas notifies you but waits for an explicit click.
  • Check now — forces an immediate update check.

Atlas updates use Tauri's signed updater. Every release is signed by the OwnLLM key, and downloads that fail verification are discarded.

Account

  • Tenant — the slug Atlas paired to. Read-only.
  • Public URLhttps://<your-slug>.ownllm.app. Click to copy.
  • Unpair this machine — see Pairing → Unpairing.
  • Open admin web — opens https://<your-slug>.ownllm.app/admin in the default browser.

Advanced

  • Log levelinfo (default), debug, or trace. Trace includes request bodies; only enable it temporarily, and don't paste trace logs publicly.
  • Gateway port — the local OpenAI-compat proxy listens here (default 11435). Change only if another service already binds this port.
  • Reset configuration — wipes Atlas-side config and recipe metadata (does not unpair, does not delete models).

Reset / reinstall

If Atlas refuses to launch:

  1. Quit Atlas (right-click tray → Quit).
  2. Move the config dir aside (so you can restore it if needed):
    # macOS
    mv ~/Library/Application\ Support/ownllm ~/Library/Application\ Support/ownllm.old
    
    # Linux
    mv ~/.config/ownllm ~/.config/ownllm.old
    
    # Windows (PowerShell)
    Move-Item $env:APPDATA\ownllm $env:APPDATA\ownllm.old
  3. Relaunch Atlas. It opens the pairing wizard again.

This procedure does not wipe the keychain entries — to start truly fresh, also unpair before quitting (or use Reset configuration under Advanced).

On this page