Skip to content

Document versioned static installer URLs - #488

Merged
domenkozar merged 2 commits into
mainfrom
fix/installer-version-selection
Oct 14, 2026
Merged

domenkozar merged 2 commits into
mainfrom
fix/installer-version-selection

Conversation

@domenkozar

@domenkozar domenkozar commented Oct 13, 2026 •

Copy link
Copy Markdown
Member

Document version selection through the installer URL:

curl -fsSL https://install.secretspec.dev/v0.21.1 | sh

Scarf maps /v{version} to https://github.com/cachix/secretspec/releases/download/v{version}/secretspec-installer.sh, retaining the exact / route to the latest release. The literal v prefix prevents the version route from matching an empty version at root. The release guide explains why the unprefixed pattern must not be retained.

Each URL fetches the selected release's existing installer, preserving its platform detection, checksums, updater, and receipt. This is a gateway feature and does not require a new CLI release. secretspec-update still updates to latest.

Updates the README, quick start, changelog, and release guide. No generated installer, cargo-dist configuration, or release workflow changes are needed. The Scarf routes have been activated and verified.

Fixes #486.

Validation:

  • npm --prefix docs run build passed, including provider credential checks, version compatibility checks, and Astro diagnostics.
  • git diff --check passed.
  • / redirects to releases/latest/download/secretspec-installer.sh.
  • /v0.21.1 redirects to releases/download/v0.21.1/secretspec-installer.sh and serves byte-for-byte identical installer content; its declared version is 0.21.1.
  • /v999.999.999 returns 404 when followed, without falling back to latest.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 13, 2026 •

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
secretspec da76686 Commit Preview URL

Branch Preview URL
Oct 14 2026, 08:04 AM

@domenkozar
domenkozar marked this pull request as draft October 13, 2026 18:39
@domenkozar
domenkozar force-pushed the fix/installer-version-selection branch from 7e3290a to 86d8e6c Compare October 13, 2026 18:40
@domenkozar domenkozar changed the title Support pinning the static installer with APP_VERSION Document versioned static installer URLs Oct 13, 2026
@domenkozar
domenkozar marked this pull request as ready for review October 14, 2026 08:06
@domenkozar
domenkozar merged commit 066caa4 into main Oct 14, 2026
62 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Static Binary installer: support installing specific version

1 participant