A Love Wins Media product

Run Garage on Linux

Garage has no desktop app for Linux, but the whole pipeline runs there. You get the garage command for indexing and search and the garage-mcp server for your AI assistant, over a PostgreSQL database you run yourself.

What you get, and what you don’t

The Linux version is the same Rust pipeline the macOS app runs inside its services, built as the garage and garage-mcp commands. CI tests it on Linux on every push, against a real PostgreSQL with pgvector.

Before you start

1. Set up the database

On Debian or Ubuntu, with the PostgreSQL project’s apt repository set up:

sudo apt install postgresql-18 postgresql-18-pgvector libgit2-dev libsqlite3-dev pkg-config
sudo -u postgres createuser "$USER"
sudo -u postgres createdb --owner "$USER" garage
sudo -u postgres psql -d garage -c 'CREATE EXTENSION IF NOT EXISTS vector'

pgvector is not a trusted extension, so postgres creates it once. Your own role, which owns the database, can then apply the rest of the schema without superuser rights. If you would rather use Docker, the pgvector/pgvector:pg18 image is what CI runs.

2. Install Garage

Build the commands from the repository with Cargo, which puts garage and garage-mcp in ~/.cargo/bin:

git clone https://github.com/rickmark/garage-rag.git
cargo install --path garage-rag/rust/garage-cli
garage version

Add --features garage-readers/tesseract to read the text in pictures with the system’s Tesseract. To update later, pull and run the same command. Prebuilt Linux binaries are not published yet.

3. Configure and initialize

garage config init --user                                 # writes ~/.garage.json
garage config set database.url postgresql:///garage       # the local socket, as your user
garage config set facts.provider ollama                   # no built-in engine on Linux
garage init-db

If Ollama or LM Studio runs on another machine, set embedding.ollama_host or embedding.lmstudio_host to its address. Garage sends documents and code only to that server. Communications such as mail never leave this computer; see privacy.

4. Add a model and your files

ollama pull bge-m3
garage register-model bge-m3 --provider ollama --dims 1024 --default

garage add-source notes ~/Documents/Notes --class document --trust authored
garage ingest
garage backfill
garage search "what did I decide about the deployment"

5. Connect your AI assistant

garage mcp-install --target claude-code-user   # or cursor, vscode, zed, windsurf, project
garage mcp-test

The assistant starts garage-mcp itself over stdio. To serve several clients from one process, run garage mcp-serve and register it with --http.

🧭 Going further

The user guide covers every command and setting, and the architecture guide explains the pipeline. Something not working on your distribution? Open an issue, or see how to contribute a fix.