Installation

The Cipher CLI is a single static binary named mdstn-cipher (no CGO). SQLite is embedded, so the CLI needs no database install. PostgreSQL 15+ is only required if you run the optional serve mode.

go install

Requires Go 1.26+.

go install github.com/madstone-tech/cipher/cmd/mdstn-cipher@latest

Docker

docker run --rm -v "$PWD:/work" -w /work \
  ghcr.io/madstone-tech/mdstn-cipher:latest encrypt secret.pdf

Prebuilt binary

Download the binary for your OS/arch from the releases page, then:

chmod +x mdstn-cipher
sudo mv mdstn-cipher /usr/local/bin/

Alternatively, run the repository’s install.sh, which downloads the matching prebuilt binary and installs it to /usr/local/bin/mdstn-cipher.

Build from source

git clone https://github.com/madstone-tech/cipher
cd cipher
go build -o mdstn-cipher ./cmd/mdstn-cipher

Verify the installation

mdstn-cipher version