Install
Every official distribution channel for sirrd (the server daemon) and sirr (the CLI client).
sirrd and sirr are separate binaries. sirrd runs the server. sirr is the CLI that talks to it. Install both if you are self-hosting; install only sirr if you are connecting to an existing server.
Install script
The fastest way on macOS and Linux. Downloads the latest release binaries directly from GitHub.
curl -fsSL https://get.sirr.dev | sh
By default this installs both sirrd and sirr. Pass a binary name to install only one:
curl -fsSL https://get.sirr.dev | sh -s sirr # CLI only
curl -fsSL https://get.sirr.dev | sh -s sirrd # server only
Binaries are installed to /usr/local/bin (or ~/.local/bin if that is not writable).
Homebrew
macOS and Linux. Includes brew services integration for sirrd.
Tap and install
brew tap sirrvault/tap
brew install sirrvault/tap/sirrd # server daemon
brew install sirrvault/tap/sirr # CLI client
Start as a background service
brew services start sirrvault/tap/sirrd
Upgrade
brew upgrade sirrvault/tap/sirrd sirrvault/tap/sirr
Scoop (Windows)
Add bucket and install
scoop bucket add sirrvault https://github.com/SirrVault/scoop-bucket
scoop install sirrvault/sirrd # server daemon
scoop install sirrvault/sirr # CLI client
Upgrade
scoop update sirrd sirr
Docker
The server is available as a multi-arch image (linux/amd64, linux/arm64). There is no CLI image — use the binary install for that.
Run
docker run -d \
--name sirrd \
-p 39999:39999 \
-v ./sirr-data:/data \
-e SIRR_MASTER_KEY="$(openssl rand -hex 32)" \
-e SIRR_DATA_DIR=/data \
sirrvault/sirrd:latest
Docker Compose
services:
sirrd:
image: sirrvault/sirrd:latest
ports:
- "39999:39999"
volumes:
- ./sirr-data:/data
environment:
SIRR_MASTER_KEY: "${SIRR_MASTER_KEY}"
SIRR_DATA_DIR: /data
restart: unless-stopped
Images are published to Docker Hub and GHCR.
Binary download
Pre-built binaries are attached to every GitHub release.
| Platform | sirrd | sirr |
|---|---|---|
| macOS (Apple Silicon) | sirrd-darwin-arm64.tar.gz | sirr-darwin-arm64.tar.gz |
| macOS (Intel) | sirrd-darwin-x64.tar.gz | sirr-darwin-x64.tar.gz |
| Linux (ARM64) | sirrd-linux-arm64.tar.gz | sirr-linux-arm64.tar.gz |
| Linux (x64) | sirrd-linux-x64.tar.gz | sirr-linux-x64.tar.gz |
| Windows (x64) | sirrd-windows-x64.zip | sirr-windows-x64.zip |
Extract and move to a directory on your $PATH:
tar -xzf sirrd-darwin-arm64.tar.gz
sudo mv sirrd /usr/local/bin/
crates.io
Build from source using Cargo. Requires Rust 1.75+.
Install
cargo install sirr-server # installs the sirrd binary
cargo install sirr # installs the sirr CLI
Upgrade
cargo install sirr-server --force
cargo install sirr --force
npm
Three packages are published under the @sirrvault scope.
@sirrvault/node — Node.js SDK
The zero-dependency TypeScript client for Node.js, Deno, and Bun.
Install
npm install @sirrvault/node
Usage
import { SirrClient } from '@sirrvault/node'
const sirr = new SirrClient({ token: process.env.SIRR_TOKEN! })
await sirr.push('API_KEY', 'sk-...', { ttl: 3600, reads: 1 })
const value = await sirr.get('API_KEY') // null if burned or expired
@sirrvault/sirr — CLI via npx
Run the Sirr CLI without installing anything.
npx
npx @sirrvault/sirr push DB_URL="postgres://..." --reads 1 --ttl 1h
npx @sirrvault/sirr get DB_URL
@sirrvault/mcp — MCP server
The Model Context Protocol server for AI agent integration. See the MCP Server page for setup instructions.
Install globally
npm install -g @sirrvault/mcp
Coming soon
These channels are on the roadmap. Star the repo to be notified when they ship.
| Channel | sirrd | sirr |
|---|---|---|
| WinGet | winget install SirrVault.Sirrd | winget install SirrVault.Sirr |
| AUR | yay -S sirrd-bin | yay -S sirr-bin |
| Snap | snap install sirrd | snap install sirr |
| Flatpak | flatpak install flathub dev.sirr.sirrd | flatpak install flathub dev.sirr.sirr |