Docs/Getting Started/Install and first run

Install and first run

Solomon ships two apps from one codebase: a desktop app (a Tauri shell around a web UI) and a native iOS app. This page gets either one running, then opens your first vault.

Desktop (macOS, Windows, Linux)

The easiest path on Apple Silicon Macs is the signed release: download the latest Solomon_x.y.z_aarch64.dmg from the download page. It's Developer-ID signed and notarized, so Gatekeeper opens it with no workaround. Only signed Apple Silicon macOS builds are distributed today — Intel Mac, Windows, and Linux builds are not yet available.

iOS (iPhone)

The iOS app is native SwiftUI and is available to testers during the private beta. Requires iOS 18 or later.

Opening your first vault

On first launch, Solomon asks you to open a vault — point it at any folder on disk. That folder becomes your vault immediately: there's no import step, no conversion, and no proprietary database. If you already have an Obsidian vault, point Solomon at that same folder — it opens as-is.

Everything in the folder that's a markdown file is a note. Special subfolders take on meaning as you use them — Agents/ for agent definitions, Skills/ for reusable instruction packets, Templates/ for note starters, Widgets/ for embedded mini-apps, and _private/ for anything you want to keep off sync and off-limits to agents entirely. None of these are required to get started — an empty folder works fine as a first vault.

Next steps

  • [[Your first note and vault]] — create a note and see how frontmatter works.
  • [[Core concepts at a glance]] — a map of everything else Solomon can do.
  • [[Local-first and CRDT sync]] — when you're ready to turn on multi-device sync (it's entirely opt-in — nothing leaves your machine until you turn it on).