Install SourceVault

macOS — Homebrew (recommended)

One command installs everything

Node, Ollama, ChromaDB, and SourceVault itself — config and secrets generated locally at install time.

# One-time: trust the tap (Homebrew 6+), then install
brew trust sourcevault-ai/tap
brew install sourcevault-ai/tap/sourcevault

# Pull the local models once (~270 MB embeddings + ~9 GB reasoning)
ollama pull nomic-embed-text
ollama pull qwen2.5-coder:14b

# Start the stack (launchd services, restart at login)
brew services start ollama
brew services start sourcevault-ai/tap/chromadb
brew services start sourcevault-ai/tap/sourcevault

# Get your dashboard token
grep DASHBOARD_TOKEN "$(brew --prefix)/etc/sourcevault/sourcevault.env"

# Open the dashboard — and put it in your Dock
sourcevault app
open ~/Applications/SourceVault.app

sourcevault app creates a real macOS app that opens your dashboard — a Dock icon from day one. Prefer the browser? open http://localhost:9000 lands in the same dashboard, where Chrome/Edge show an install icon in the address bar (or Settings → About → Install app) and Safari installs via File → Add to Dock.

From the dashboard, connect GitHub/GitLab/Bitbucket and index your first repository — or from the terminal:

cd "$(brew --prefix)/opt/sourcevault/libexec"
npm run code-repos -- add <git-url>
npm run index-codebase -- <repo-name>

Apple Silicon or Intel, macOS 13+. Recommended: 8+ cores, 24 GB+ RAM, 100 GB free disk (the reasoning model is the big one). Upgrades: brew update && brew upgrade sourcevault — the service restarts itself; no manual restart step.

Linux — Ubuntu / Debian

One command here too

Downloads the latest release (sha256-verified), installs dependencies (Node 24, Docker for ChromaDB, Ollama — GPU-aware via Ollama's official installer), generates secrets, and registers systemd user services:

curl -fsSL https://sourcevault.ai/install.sh | bash

Prefer to see the plan first? Preview without changing anything:

curl -fsSL https://sourcevault.ai/install.sh | bash -s -- --dry-run

The script is short and readable — inspect it here before piping it, as you should with any installer. Re-running it later updates SourceVault in place, preserving your index and history.

Windows — via WSL2 Ubuntu

One command from PowerShell

SourceVault runs inside WSL2 Ubuntu on Windows. This sets up WSL2 + Ubuntu if needed (first-time WSL installs need one reboot — just re-run the command after), enables systemd, and runs the Linux installer:

irm https://sourcevault.ai/install.ps1 | iex

WSL2 forwards localhost automatically — the dashboard at http://localhost:9000/dashboard/ works straight from your Windows browser (and installs as a desktop app from there). Inspect the script.

Team server — Docker Compose

One stack, every OS connects via the browser

Run SourceVault + ChromaDB on one box (GPU box for Ollama optional); teammates on Windows/macOS/Linux use the dashboard — installable as a desktop PWA — over the network:

docker compose up --build -d

Front it with a TLS reverse proxy for production; the deploy guide in your bundle covers nginx, Caddy, and Traefik.

After the trial

Licensing

The 7-day trial covers the full core product with one repository. A license key — entered in the dashboard under Settings → License, verified offline, no phone-home — continues past the trial, raises the repository cap, and unlocks plan features like multi-repo Ask.

1. Pick a plan — Starter and Pro check out instantly; your key arrives by email.
2. Paste the key in Settings → License → Unlock.
3. Lost your key? Recover it here with your purchase email.