netbird-ssh

Configure and troubleshoot Netbird's built-in SSH server using CLI flags.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/renne/skills --skill netbird-ssh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: netbird-ssh
Source: https://github.com/renne/skills/tree/main/netbird/ssh
Command: npx skills add https://github.com/renne/skills --skill netbird-ssh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps users configure and troubleshoot Netbird's built-in SSH server, enabling secure, browser-based access to their Netbird peers and resolving common connection issues.

Core Features & Use Cases

  • SSH Server Configuration: Guides users on enabling and configuring Netbird's SSH server using command-line flags.
  • Dashboard SSH Access: Explains how the Netbird dashboard utilizes the built-in SSH server for browser-based SSH sessions.
  • Troubleshooting: Provides solutions for common errors like "SSH connection failed" and addresses issues with OAuth2 re-authentication.
  • Use Case: A user wants to SSH into a Netbird peer directly from the Netbird dashboard but is encountering "SSH connection failed" errors. This Skill will guide them through enabling the necessary flags (--allow-server-ssh, --enable-ssh-root) and explain the dashboard's SSH mechanism.

Quick Start

Configure Netbird SSH by running netbird up --allow-server-ssh --enable-ssh-root --disable-ssh-auth.

Frequently Asked Questions about netbird-ssh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable SSH access to Netbird peers from the dashboard?

To enable SSH access to Netbird peers from the dashboard, run the Netbird client with the --allow-server-ssh flag. This activates the built-in SSH server, allowing the dashboard to initiate secure, browser-based SSH sessions to your peers.

Why does my Netbird dashboard SSH connection fail?

A Netbird dashboard SSH connection fails when the built-in SSH server is not enabled or configured correctly. You must apply specific CLI flags like --allow-server-ssh and verify systemd service configurations to resolve the connection error.

How do I configure root login for Netbird SSH?

To configure root login for Netbird SSH, include the --enable-ssh-root flag when starting the Netbird client. This modifies the built-in SSH server settings to permit root access for dashboard sessions and peer connectivity.

Can I disable authentication for Netbird SSH sessions?

Yes, you can disable authentication for Netbird SSH sessions by using the --disable-ssh-auth command-line flag. This bypasses standard authentication checks, which is useful for testing or specific self-hosted deployment configurations.

How do I fix OAuth2 re-authentication issues in self-hosted Netbird SSH?

Fixing OAuth2 re-authentication issues in self-hosted Netbird SSH requires adjusting your systemd service configurations and CLI flags. This ensures the built-in SSH server correctly handles token refreshes and re-authentication flows for dashboard access.