OwnLLM Docs
Install

Desktop app (Atlas)

Install the OwnLLM Atlas desktop app on macOS, Windows, or Linux.

Atlas is the OwnLLM native desktop app — built with Tauri, signed and notarized for production distribution. Use it on a workstation when you want a GUI for pairing, model management, and a system tray indicator that the agent is running. On a headless server, the CLI is the right pick.

macOS

Download the .dmg from the download page, open it, and drag OwnLLM Atlas into /Applications. The app is signed by OwnLLM, Inc. and notarized — Gatekeeper accepts it without an override.

open /Applications/OwnLLM\ Atlas.app

The first launch opens the pairing wizard; paste your key and you're done.

Windows

Download the signed .msi from the download page and run it. The installer:

  • Drops OwnLLM.exe and supporting binaries (ollama.exe, cloudflared.exe) into %PROGRAMFILES%\OwnLLM\.
  • Adds an entry to Add or remove programs.
  • Registers Atlas as a Windows Service set to Automatic (Delayed Start) so the agent comes back after reboots.

The MSI is signed with our Authenticode certificate (OwnLLM, Inc.). SmartScreen accepts it; if you ever see a warning, verify the signer before clicking through.

Linux

Three packages are published per release:

  • OwnLLM-Atlas_<version>_amd64.deb — Debian / Ubuntu.
  • OwnLLM-Atlas-<version>.x86_64.rpm — Fedora / RHEL.
  • OwnLLM-Atlas_<version>_amd64.AppImage — distro-agnostic, no install.
# Debian / Ubuntu
sudo dpkg -i OwnLLM-Atlas_*_amd64.deb

# Fedora / RHEL
sudo rpm -i OwnLLM-Atlas-*.x86_64.rpm

# AppImage
chmod +x OwnLLM-Atlas_*_amd64.AppImage
./OwnLLM-Atlas_*_amd64.AppImage

The first launch opens the pairing wizard.

What Atlas bundles

The Atlas installer ships with everything needed to serve inference out of the box:

  • ollama — the inference runtime.
  • cloudflared — the outbound tunnel client.
  • The OwnLLM agent gateway.

You don't need to install Ollama or cloudflared separately. The bundled versions are pinned to whatever Atlas ships in this release; the control plane verifies them via the runtime manifest at startup.

Auto-update

Atlas uses Tauri's signed updater. Updates are atomic, verified, and applied at the next app start. You can pick Stable or Beta in Settings → Updates (defaults to Stable).

CLI vs Atlas

CLI (ownllm)Atlas (desktop)
Best forServers, VPS, headless boxesMac Studio, workstations, dev machines
Footprint~20 MB single binary~120 MB installer (bundles Ollama + cloudflared)
GUINone — terminal onlyPairing wizard, dashboard, tray icon
Auto-updateownllm update (manual)Background, signed, atomic
Pairingownllm pair <key>Paste key into wizard

A given tenant can run either Atlas or the CLI on its GPU host — not both at once.

Next steps

  • Desktop overview — what each screen does, the tray menu, and the system service it registers (lands in the next release).
  • Pairing walks through the first-run wizard (lands in the next release).

On this page