Skip to content

BoringCache CLI v1.10.2

Choose a tag to compare

View all tags
@github-actions github-actions released this 05 Mar 08:47
· 148 commits to main since this release
v1.10.2
50d6520

BoringCache CLI Release v1.10.2

🚀 What's New

  • run command: transactional cache wrapper (restore → exec → save) with signal handling and correct exit codes
  • Maven cache-registry adapter support
  • BORINGCACHE_TOKEN_FILE env var: read API token from a file path (useful in Docker builds with secret mounts)
  • delete now also purges proxy/cache-registry internal data for the deleted tag
  • Unified cache-registry command with native OCI + Bazel + Gradle + Maven + Nx + Turborepo + sccache + Go support
  • Cross-platform support: Linux (AMD64/ARM64), macOS (Apple Silicon), Windows (AMD64)
  • Zstd-compressed tar archives with optional age encryption
  • Streaming I/O for large caches
  • Server-signed manifests with warn-only verification

📦 Downloads

CLI Binaries (GitHub-hosted runners)

Generic Linux (Recommended for wide compatibility)

  • Linux AMD64: boringcache-linux-amd64 (Ubuntu 22.04 base)
  • Linux ARM64: boringcache-linux-arm64 (Ubuntu 22.04 base)

Ubuntu (Native builds)

  • Ubuntu 22.04 AMD64: boringcache-ubuntu-22.04-amd64
  • Ubuntu 22.04 ARM64: boringcache-ubuntu-22.04-arm64
  • Ubuntu 24.04 AMD64: boringcache-ubuntu-24.04-amd64
  • Ubuntu 24.04 ARM64: boringcache-ubuntu-24.04-arm64
  • Ubuntu 25.04 AMD64: boringcache-ubuntu-25.04-amd64
  • Ubuntu 25.04 ARM64: boringcache-ubuntu-25.04-arm64

Debian (Docker builds for precise compatibility)

  • Debian Bookworm (12) AMD64: boringcache-debian-bookworm-amd64
  • Debian Bookworm (12) ARM64: boringcache-debian-bookworm-arm64
  • Debian Bullseye (11) AMD64: boringcache-debian-bullseye-amd64
  • Debian Bullseye (11) ARM64: boringcache-debian-bullseye-arm64

Alpine Linux (musl, statically linked)

  • Alpine AMD64: boringcache-alpine-amd64

Arch Linux (Latest rolling release)

  • Arch AMD64: boringcache-arch-amd64
  • Arch ARM64: boringcache-arch-arm64

macOS (Native builds)

  • macOS 14+ ARM64 (M1/M2/M3): boringcache-macos-14-arm64
  • macOS 15+ ARM64 (M1/M2/M3/M4): boringcache-macos-15-arm64

Windows (Native builds)

  • Windows Server 2022 AMD64: boringcache-windows-2022-amd64.exe

🔧 Installation

Ubuntu 22.04

# AMD64
curl -L https://github.com/boringcache/cli/releases/download/v1.10.2/boringcache-ubuntu-22.04-amd64 -o boringcache
chmod +x boringcache && sudo mv boringcache /usr/local/bin/

# ARM64
curl -L https://github.com/boringcache/cli/releases/download/v1.10.2/boringcache-ubuntu-22.04-arm64 -o boringcache
chmod +x boringcache && sudo mv boringcache /usr/local/bin/

Ubuntu 24.04

# AMD64
curl -L https://github.com/boringcache/cli/releases/download/v1.10.2/boringcache-ubuntu-24.04-amd64 -o boringcache
chmod +x boringcache && sudo mv boringcache /usr/local/bin/

# ARM64
curl -L https://github.com/boringcache/cli/releases/download/v1.10.2/boringcache-ubuntu-24.04-arm64 -o boringcache
chmod +x boringcache && sudo mv boringcache /usr/local/bin/

Ubuntu 25.04

# AMD64
curl -L https://github.com/boringcache/cli/releases/download/v1.10.2/boringcache-ubuntu-25.04-amd64 -o boringcache
chmod +x boringcache && sudo mv boringcache /usr/local/bin/

# ARM64
curl -L https://github.com/boringcache/cli/releases/download/v1.10.2/boringcache-ubuntu-25.04-arm64 -o boringcache
chmod +x boringcache && sudo mv boringcache /usr/local/bin/

macOS

# Apple Silicon (macOS 14+)
curl -L https://github.com/boringcache/cli/releases/download/v1.10.2/boringcache-macos-14-arm64 -o boringcache
chmod +x boringcache && sudo mv boringcache /usr/local/bin/

# Apple Silicon (macOS 15+ latest)
curl -L https://github.com/boringcache/cli/releases/download/v1.10.2/boringcache-macos-15-arm64 -o boringcache
chmod +x boringcache && sudo mv boringcache /usr/local/bin/

Windows (PowerShell)

# Windows 10+ / Server 2019+
Invoke-WebRequest -Uri "https://github.com/boringcache/cli/releases/download/v1.10.2/boringcache-windows-2022-amd64.exe" -OutFile "boringcache.exe"
# Add to PATH or move to desired location

🔐 Verify Downloads

Each release includes a SHA256SUMS file for integrity verification:

# Download the binary and checksums
curl -LO https://github.com/boringcache/cli/releases/download/v1.10.2/boringcache-linux-amd64
curl -LO https://github.com/boringcache/cli/releases/download/v1.10.2/SHA256SUMS

# Verify the binary
sha256sum -c SHA256SUMS --ignore-missing

⚡ Usage Examples

# Authenticate
boringcache auth --token your-api-token

# Wrap restore -> command -> save in one call
boringcache run my-workspace "node-deps:node_modules,build-cache:target" -- npm test

# List cache entries
boringcache ls my-workspace

Releases: https://github.com/boringcache/cli/releases

Assets 21
Loading