NetBird Client
NetBird Client is the open-source NetBird agent that installs on machines to join a WireGuard-based private network for secure remote and peer-to-peer access,…
Platform availability
Available on 6 of 10 platforms
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
88/100 Excellent
- Maintained
- 100last commit 12 days ago
- Popular
- 9030,840 GitHub stars
- Easy to install
- 856 install platforms, install notes, Docker image
- Light to run
- 602 GB minimum RAM, runs on ARM
Availability: platform listings confirmed today, links checked 7 days ago
- GitHub stars
- 30,840
- Open issues
- 797
- Last commit
- 2026-11-09
- Latest release
- v0.82.0
- Activity
- declining
Checked 12 days ago - source: GitHub (netbirdio/netbird)
Resources & Compatibility
Minimum requirements: 2 GB RAM, 1 CPU core(s). ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Use a setup key to join When you set up the NetBird background service, pass your admin-provided setup key (the code that lets a computer join), for example with netbird service install --setup-key. Without a valid key, the client can't register itself and will not connect to your private network. source
- If self-hosting, create owner account If you are running your own NetBird server, create the owner account with an email and password during the initial setup. Until this is done, the instance won't let you manage devices or create setup keys for other computers. source
- If self-hosting, set domain/email In the setup.env config file, put your real NetBird domain and a valid Let's Encrypt (free HTTPS certificate) email before starting the service. Missing or wrong values can break HTTPS and make the web setup page or login inaccessible. source
- Client only The client is not needed if you are only installing the NetBird server stack. source
Fetched 37 days ago - each note links to its source
Variants
Alternatives (12)
- Fossorial Pangolin - Open-source identity-based remote access platform using WireGuard, offering unified management, tunneled connections, granular access contr…
- Headscale - Headscale is an open-source, self-hosted implementation of the Tailscale control server.
- LogMeIn Hamachi - Seamlessly connects devices and networks, extending LAN-like connectivity to mobile users and teams with a secure, hosted VPN service.
- OpenVPN Connect - OpenVPN Connect provides flexible VPN solutions to secure your data communications, whether it's for Internet privacy, remote access for em…
- Outline VPN - Journalists need safe access to information to research issues, communicate with sources, and report the news.
- Rayfish - A peer-to-peer mesh VPN with zero infrastructure.
- Remote.it - Remote.it is a tool that lets you securely access your home or office computer from anywhere.
- Serveo - Serveo exposes local servers to the internet using SSH tunneling.
- SoftEther VPN - SoftEther VPN ("SoftEther" means "Software Ethernet") is one of the world's most powerful and easy-to-use multi-protoco…
- Tailscale - Private networks made easy.
- Twingate-Connector
- ZeroTier - ZeroTier is an open-source, cross-platform virtual LAN/VPN service that connects your devices and servers into one private network, so you…
Checked 51 days ago - source: AlternativeTo
Common questions
How do I register a computer with my self-hosted NetBird server?
Pass the admin-provided setup key when installing the NetBird background service. For example, run netbird service install --setup-key. Without a valid key the client cannot register or connect.
What must be set in setup.env before starting a self-hosted NetBird server?
Put your real NetBird domain and a valid Let's Encrypt email in the file. Missing or wrong values can break HTTPS and make the setup page or login inaccessible.
Why can't I create setup keys on a fresh self-hosted NetBird instance?
You must first create the owner account with an email and password during initial setup. Until that account exists, the instance will not let you manage devices or create setup keys.
Can NetBird use an external identity provider for login and MFA?
Yes, NetBird supports session-based SSO and MFA with providers such as Okta, Microsoft, and Google. It can apply the provider's MFA settings and periodic re-authentication.
Where should I report self-hosted NetBird setup or maintenance problems?
Use the Community Support forum self-hosted category to report installation problems and share logs. That is the place for help from the community and team.
Answers sourced from docs.netbird.io, docs.netbird.io, docs.netbird.io, forum.netbird.io, netbird.io
Community
- [SOLVED] Netbird Client - Timeout connecting to self-hosted DNS ... (forum)
- Welcome to the Netbird Community Forum! (forum)
Collected 53 days ago - public community threads