Installation
The SecretServer CLI (ss) is written in Go and ships as a single self-contained binary — no runtime or dependencies required.
Language
Go 1.24
Single static binary. No interpreter, no runtime, no version conflicts.
Platforms
macOS · Linux · Windows
Native binaries for amd64 and arm64 (Apple Silicon supported).
Option 1 — curl installer macOS / Linux
curl -sSL https://secretserver.io/install | sh
Detects your OS and architecture, downloads the latest release from GitHub, and installs to /usr/local/bin/ss.
Option 2 — Homebrew macOS / Linux
brew install afterdark/tap/ss
Installs from our official Homebrew tap. Updates automatically with brew upgrade.
Option 3 — Direct download
Download a pre-built binary from the GitHub releases page.
| Platform | Architecture | File |
|---|---|---|
| macOS | Apple Silicon (arm64) | ss_VERSION_darwin_arm64.tar.gz |
| macOS | Intel (amd64) | ss_VERSION_darwin_amd64.tar.gz |
| Linux | amd64 | ss_VERSION_linux_amd64.tar.gz |
| Linux | arm64 | ss_VERSION_linux_arm64.tar.gz |
| Windows | amd64 | ss_VERSION_windows_amd64.zip |
Option 4 — Linux packages .deb / .rpm
# Debian / Ubuntu wget https://github.com/afterdark/secretserver-cli/releases/latest/download/ss_VERSION_linux_amd64.deb sudo dpkg -i ss_VERSION_linux_amd64.deb # RHEL / Fedora / Amazon Linux wget https://github.com/afterdark/secretserver-cli/releases/latest/download/ss_VERSION_linux_amd64.rpm sudo rpm -i ss_VERSION_linux_amd64.rpm
Configuration
The CLI authenticates using an API key. Set it as an environment variable or in the config file.
# Environment variable (recommended for CI/CD) export SS_API_KEY=sk_live_... export SS_API_URL=https://api.secretserver.io # optional, this is the default # Or write a config file mkdir -p ~/.adkm cat > ~/.adkm/config.yaml <<EOF api_key: sk_live_... api_url: https://api.secretserver.io EOF
Generate an API key in your account settings. Precedence: --api-key flag > SS_API_KEY env > ~/.adkm/config.yaml.
Verify installation
ss version # ss version 0.3.0 # commit: abc1234 # built: 2026-02-17T00:00:00Z ss secret --help