Skip to content

Correct the profile removal and SSH authentication privilege wording - #895

Merged
braginini merged 3 commits into
mainfrom
docs-privilege-wording-fixes
Aug 1, 2026
Merged

Correct the profile removal and SSH authentication privilege wording#895
braginini merged 3 commits into
mainfrom
docs-privilege-wording-fixes

Conversation

@lixmal

@lixmal lixmal commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Follow-up to #894. Corrects three statements that do not match the client code on main (0f5d2d91f).

  • Say that only deregistration is refused, not profile removal: RemoveProfile treats deregistration as best-effort, so an unprivileged caller removes the profile locally and the peer stays registered on the management server
  • Fix the inverted direction for SSH authentication: the guarded change is turning it off, so "turning these settings off never requires privileges" was wrong in the SSH and desktop app notes
  • Add netbird down to the port-forwarding examples, since up returns early on a connected client without applying the flags
  • Note that a profile written before the SSH server flag existed counts as having it enabled, so the management URL and deregistration guards apply on those installations

Summary by CodeRabbit

  • Documentation
    • Clarified that enabling the SSH server, root login, or disabling SSH authentication requires administrator privileges.
    • Updated SSH setup and troubleshooting instructions with elevated command examples and MDM guidance.
    • Documented Windows named-pipe support and expanded socket configuration options.
    • Explained authorization behavior and restrictions for privileged operations over TCP and JSON sockets.
    • Added troubleshooting guidance for permission-denied errors and secure debug bundle uploads.

@vercel

vercel Bot commented Jul 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Jul 30, 2026 1:46pm

Request Review

@coderabbitai

coderabbitai Bot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Warning

Review limit reached

@lixmal, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 37 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: d6260218-79db-4298-8672-3e16c63f7e80

📥 Commits

Reviewing files that changed from the base of the PR and between 218cb6b and bdf3c4a.

📒 Files selected for processing (5)
  • src/pages/client/desktop-app.mdx
  • src/pages/client/grpc-socket.mdx
  • src/pages/get-started/cli.mdx
  • src/pages/help/troubleshooting-client.mdx
  • src/pages/manage/peers/ssh.mdx
📝 Walkthrough

Walkthrough

Changes

Socket documentation

Layer / File(s) Summary
Socket addressing and authorization guidance
src/pages/client/grpc-socket.mdx, src/pages/client/json-socket.mdx
Documents Windows named-pipe defaults, caller identity handling, privileged operation denials, and related troubleshooting responses.

SSH and CLI documentation

Layer / File(s) Summary
SSH privilege requirements
src/pages/client/desktop-app.mdx, src/pages/manage/peers/ssh.mdx, src/pages/manage/peers/access-infrastructure/...
Explains elevated SSH configuration, administrator or MDM paths, and safe-state changes.
CLI defaults and debug upload requirements
src/pages/get-started/cli.mdx, src/pages/help/troubleshooting-client.mdx
Updates daemon address defaults, SSH troubleshooting commands, and debug bundle upload requirements.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

  • netbirdio/docs#894: Directly overlaps the SSH privilege, named-pipe, socket authorization, and debug upload documentation.
  • netbirdio/docs#859: Introduces related socket documentation and named-pipe and privileged-operation guidance.
  • netbirdio/docs#881: Touches the SSH target-peer documentation updated here.

Suggested reviewers: pizzalovingnerd

Poem

I nibbled the notes till the pathways were clear,
Named pipes now guide Windows near.
SSH asks admins to lend a hand,
TCP knows no caller in the land.
Privileged switches wait by command,
A tidy docs burrow, perfectly planned.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title matches the main documentation updates around profile removal and SSH authentication privilege wording.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs-privilege-wording-fixes

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 6

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/pages/client/desktop-app.mdx`:
- Around line 79-91: The desktop-app privilege note currently implies that MDM
can configure all three SSH-related switches. Narrow the MDM fallback sentence
to the Enable SSH Server setting only, or explicitly document separate MDM
policies for Enable Root Login and SSH authentication; keep the existing
privilege and safe-state behavior unchanged.

In `@src/pages/client/grpc-socket.mdx`:
- Around line 116-119: Update the introductory authorization statement in the
socket documentation to scope the “any local user” claim to sockets accessible
to local users, or specifically to the default Unix socket. Preserve the
existing platform-specific credential and refusal behavior described in the
following sentences.

In `@src/pages/get-started/cli.mdx`:
- Line 836: Update both `--upload-bundle-insecure` flag descriptions in the CLI
documentation to replace “requires root” with platform-neutral wording: require
root on Linux/macOS or an administrator on Windows, matching the existing
wording in the troubleshooting documentation.
- Around line 512-514: Add Windows-specific elevated PowerShell or Command
Prompt variants for the privilege-required NetBird commands near the SSH
examples, including the occurrences at the referenced additional sections.
Alternatively, explicitly label the existing sudo commands as Linux/macOS-only,
while ensuring Windows users have an administrator-elevated equivalent.
- Line 523: Update the CLI troubleshooting guidance around the
`--disable-ssh-auth` command to warn that it expands SSH access to any peer with
network access and should only be used temporarily. Add the corresponding
command to re-enable SSH authentication afterward, while preserving the existing
disable-authentication command.

In `@src/pages/help/troubleshooting-client.mdx`:
- Around line 311-314: Update the Note describing --upload-bundle-insecure to
explicitly state that it bypasses TLS certificate verification and may expose
diagnostic data in transit. Add a brief recommendation to use it only with a
trusted private endpoint or network and to enable --anonymize when appropriate.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: f6cd1712-bfa4-4903-b2cb-c8dadd530305

📥 Commits

Reviewing files that changed from the base of the PR and between cb6aa7b and 218cb6b.

📒 Files selected for processing (7)
  • src/pages/client/desktop-app.mdx
  • src/pages/client/grpc-socket.mdx
  • src/pages/client/json-socket.mdx
  • src/pages/get-started/cli.mdx
  • src/pages/help/troubleshooting-client.mdx
  • src/pages/manage/peers/access-infrastructure/setup-keys-add-servers-to-network.mdx
  • src/pages/manage/peers/ssh.mdx

Comment thread src/pages/client/desktop-app.mdx
Comment thread src/pages/client/grpc-socket.mdx Outdated
Comment thread src/pages/get-started/cli.mdx Outdated
Comment thread src/pages/get-started/cli.mdx Outdated
Comment thread src/pages/get-started/cli.mdx Outdated
Comment thread src/pages/help/troubleshooting-client.mdx
@braginini
braginini merged commit ddec3c2 into main Aug 1, 2026
5 checks passed
@braginini
braginini deleted the docs-privilege-wording-fixes branch August 1, 2026 13:57
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.

2 participants