Skip to content

Install ​

Install the Securock CLI on macOS or Linux (amd64 / arm64), then confirm the binary is on your PATH.

Installer script ​

sh
curl -fsSL https://securock.sh/install | sh

Pin a release tag:

sh
curl -fsSL https://securock.sh/install | sh -s -- --version v0.2.1

The script downloads securock_OS_ARCH.tar.gz from GitHub Releases (for example securock_darwin_arm64.tar.gz), checks checksums.txt (SHA-256), and verifies GitHub attestations with gh unless attestation is skipped.

Option / envMeaning
--version TAGInstall that release instead of latest
--skip-attestationSkip gh attestation verify
SKIP_ATTESTATION=1Same as --skip-attestation
INSTALL_DIRInstall path (default /usr/local/bin if writable, else ~/.local/bin)
GH_TOKEN / GITHUB_TOKENOptional auth for GitHub downloads

Supported platforms: darwin / linux × amd64 / arm64.

PATH ​

If the installer chose ~/.local/bin, ensure that directory is on your PATH:

sh
export PATH="$HOME/.local/bin:$PATH"

Attestation ​

gh is required for attestation checks unless you skip them:

sh
SKIP_ATTESTATION=1 curl -fsSL https://securock.sh/install | sh
# or
curl -fsSL https://securock.sh/install | sh -s -- --skip-attestation

Skip attestation only when you cannot run gh and accept verifying the checksum yourself.

Homebrew ​

sh
brew tap securock/securock https://github.com/securock/securock
brew install --HEAD securock

Go ​

sh
go install github.com/securock/securock/cmd/securock@latest

Requires a working Go toolchain. The resulting binary is not attested by the installer path; prefer the release installer in production CI.

Manual verification ​

Release archives use lowercase GOOS names, for example securock_darwin_arm64.tar.gz. Verify the archive or the extracted binary:

sh
gh attestation verify securock_darwin_arm64.tar.gz --repo securock/securock
gh attestation verify ./securock --repo securock/securock

Troubleshooting ​

SymptomWhat to check
unsupported OS / architectureInstaller supports darwin/linux amd64/arm64 only
install gh or set SKIP_ATTESTATION=1Install GitHub CLI or skip attestation
command not found: securockAdd INSTALL_DIR (often ~/.local/bin) to PATH
Permission denied under /usr/local/binRe-run without write access so it falls back to ~/.local/bin, or set INSTALL_DIR

Next steps ​

  • Quick start — walk the lock → diff → verify loop
  • Usage — CLI commands and flags

Released under the Apache-2.0 License. Pre-1.0: all lockfile resolvers are stable.