Install SourceVault

No GPU or 24 GB of RAM?

Try lite mode: it skips models and the vector store

Set SOURCEVAULT_LITE=1 and SourceVault leaves out the model stack entirely. It runs without Ollama or ChromaDB, and the only requirement is Node. You get keyword + symbol-graph code search through the same ranking pipeline, exact file reads, the dashboard, and the MCP server for your agents — everything except semantic search and grounded Ask answers, which decline with an honest message instead of degrading silently. If you later add the full stack, unset the flag and reindex: the same install upgrades in place.

SOURCEVAULT_LITE=1 npm run index-codebase -- <repo-name>
SOURCEVAULT_LITE=1 npm start

Lite mode is the fastest way to evaluate SourceVault on a laptop that can't run local models. The Sentinel policy layer, audit chain, licensing, and trial behave identically in both modes.

macOS · Homebrew (recommended)

One command installs everything

Node, Ollama, ChromaDB, and SourceVault itself, with 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 + ~19 GB reasoning)
ollama pull nomic-embed-text
ollama pull qwen3-coder:30b

# 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

# That's every service. The optional Qdrant history engine needs no
# install: enable it later in Settings and SourceVault downloads,
# verifies, and runs it for you.

# 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, so you get a Dock icon from day one. If you'd rather use the browser, open http://localhost:9000 lands in the same dashboard, where Chrome and 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). Tight on RAM? Pull qwen2.5-coder:14b (~9 GB) instead and set OLLAMA_CHAT_MODEL=qwen2.5-coder:14b — the compact profile; published benchmark numbers are from the default model above. Upgrades: brew update && brew upgrade sourcevault. The service restarts itself; there is no manual restart step.

Linux · Ubuntu / Debian

Pipe the install script to bash

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

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

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

Start in PowerShell, land in WSL2

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, so 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 and ChromaDB on one box (a GPU box for Ollama is optional); teammates on Windows, macOS, or Linux use the dashboard over the network, installable as a desktop PWA. The optional Qdrant history engine needs no compose entry either: SourceVault manages it inside its own container and state volume when enabled.

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 source. A license key continues past the trial, raises the source cap, and unlocks plan features like multi-repo Ask. Enter it in the dashboard under Settings → License; it verifies offline, with no phone-home.

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