Repository navigation
Conversation
- Explain how to verify the download's SHA256 checksum on Linux, macOS and Windows before extracting it (closes prometheus#1946). - Use `cd prometheus-*/` so the wildcard only matches the extracted directory; `cd prometheus-*` fails in bash and zsh when the tarball is in the same directory. - Note where browser downloads land and what `no matches found` means. - Add a NOTE on the macOS Gatekeeper block for browser-downloaded binaries and the two ways to allow them. Part of prometheus#3137. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: granman <45244251+granman3@users.noreply.github.com>
granman3
force-pushed
the
docs/macos-first-steps
branch
from
October 14, 2026 01:05
72044b1 to
5670dd8
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Part of #3137 (the "macOS binary path works for first-timers" section). Closes #1946.
@RichiH (per MAINTAINERS.md) and @lasomethingsomething (epic author)
What changed (
docs/introduction/first_steps.md, "Downloading Prometheus")sha256sum(Linux),shasum -a 256(macOS) orGet-FileHash(Windows PowerShell).cd prometheus-*→cd prometheus-*/. With the tarball still next to the extracted directory (the normal case), the old command matches both and fails (cd: too many argumentsin bash,cd: string not in pwdin zsh). The trailing slash matches only directories in both shells.~/Downloads, andno matches foundmeans you're in the wrong directory.xattr -dr com.apple.quarantine ..How I tested
macOS 27.0.1 (Apple Silicon), Prometheus v3.15.0
darwin-arm64:shasum -a 256andsha256sumhashes matchsha256sums.txt.cd prometheus-*fails in bash and zsh with the tarball present;cd prometheus-*/works in both.com.apple.quarantine,spctl --assessrejects it (ad-hoc signature only), and running it gets SIGKILL. System Settings then shows "“prometheus” was blocked to protect your Mac" with an Allow Anyway button. Afterxattr -dr com.apple.quarantine .it runs normally. Acurldownload isn't quarantined and runs as-is.I've only seen the System Settings wording on macOS 27, so older releases may label the button differently. Happy to adjust the wording or split this up.
🤖 Generated with Claude Code