Skip to content

CLI install: add brew trust step for third-party tap#5214

Open
nat hartman (nathartman) wants to merge 2 commits into
mainfrom
cli-install-brew-trust
Open

CLI install: add brew trust step for third-party tap#5214
nat hartman (nathartman) wants to merge 2 commits into
mainfrom
cli-install-brew-trust

Conversation

@nathartman

Copy link
Copy Markdown
Contributor

What

Adds brew trust viamrobotics/brews to the Homebrew install steps in the shared CLI install include (static/include/how-to/install-cli.md), which renders on the CLI overview page and every other page that reads it.

Why

Homebrew now requires third-party taps to be explicitly trusted before any of their formulae will load. The currently-documented sequence:

brew tap viamrobotics/brews
brew install viam

fails on an up-to-date Homebrew with:

Error: Refusing to load formula viamrobotics/brews/viam from untrusted tap viamrobotics/brews.

Trusting only the viam formula (brew trust --formula viamrobotics/brews/viam, which the error message suggests) is not enough — the install still fails on a dependency pulled from the same tap. Trusting the whole tap is what works.

Change

Insert brew trust viamrobotics/brews between the tap and install steps, in both Homebrew blocks (the macOS tab and the Linux x86_64 tab):

brew tap viamrobotics/brews
brew trust viamrobotics/brews
brew install viam

The Linux curl, Windows, and source-build tabs are unaffected.

Notes

  • Draft — flagging for docs-team review of wording/placement.
  • Editing the shared include is the single-source fix; no per-page edits needed.
  • Verified against a real failed-then-fixed install on macOS (Homebrew tap-trust gate).

Homebrew now requires third-party taps to be explicitly trusted, so the
documented `brew tap` + `brew install viam` sequence fails with "Refusing
to load formula from untrusted tap". Add `brew trust viamrobotics/brews`
between the tap and install steps in the macOS and Linux x86_64 tabs.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
@netlify

netlify Bot commented Jul 15, 2026

Copy link
Copy Markdown

Deploy Preview for viam-docs ready!

Name Link
🔨 Latest commit 4bcd7d7
🔍 Latest deploy log https://app.netlify.com/projects/viam-docs/deploys/6a57c12913c3130007fe5289
😎 Deploy Preview https://deploy-preview-5214--viam-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 44 (🟢 up 1 from production)
Accessibility: 100 (no change from production)
Best Practices: 100 (no change from production)
SEO: 92 (no change from production)
PWA: 60 (no change from production)
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@viambot viambot added the safe to build This pull request is marked safe to build from a trusted zone label Jul 15, 2026
@nathartman
nat hartman (nathartman) marked this pull request as ready for review July 15, 2026 16:33

@ale7714 Ale Paredes (ale7714) left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚀 ty!

@btshrewsbury-viam

btshrewsbury-viam commented Jul 15, 2026

Copy link
Copy Markdown
Collaborator

Heads-up: two brew blocks bypass this include and hit the same trust gate — the inline copy in docs/try/part-3.md and the viam-server one-liner in docs/reference/viam-server.md. Worth folding into this PR if you want one complete fix (a separate PR/issue for them, #5216/#5215, was closed as duplicate of this one).

Two more brew install commands hit the same Homebrew 6 tap-trust
refusal: the inline copy of the CLI install commands in
docs/try/part-3.md and the viam-server one-liner in
docs/reference/viam-server.md. Same fix as the include: trust the
tap between tap and install.
@btshrewsbury-viam

Copy link
Copy Markdown
Collaborator

Pushed 4bcd7d7e3 adding the trust step to the two brew blocks that bypass the include, so this PR is now the complete fix: the inline CLI install copy in docs/try/part-3.md and the viam-server one-liner in docs/reference/viam-server.md (now brew tap ... && brew trust ... && brew install viam-server). The "older version of the Homebrew tap" section in viam-server.md needs no change: it only applies to users who already have the tap installed and trusted. prettier, markdownlint, vale, and make build-prod all pass locally.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

safe to build This pull request is marked safe to build from a trusted zone

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants