v0.62.0
netbirdio/netbirdv0.62.0Jan 7, 2026by mlsmaycon
AI Summary
A major release introducing embedded identity provider support, allowing self-hosted setups to work without external IdPs. Includes dashboard enhancements like user creation flows and instance setup wizards.
Key Highlights
- Simplified Identity Provider Management with embedded IdP
- Dashboard enhancements: setup wizard and user creation flow
- Client enhancements: fixed connection state and added port forwarding
- Management improvements: refactored peer validation logic
New Features
- Embedded Identity Provider
- Instance setup wizard
- User creation flow with password generation
- Identity Providers settings tab
- Port forwarding support for SSH proxy
- eBPF WireGuard proxy disable support
Full Release Notes
## Release Notes for v0.62.0 ### What's New #### 🔓 Simplified Identity Provider Management Self-hosted NetBird no longer requires an external identity provider by default. Local users now work out of the box without any IdP dependency. **What's changed:** - **No IdP required** - Create and manage users directly from the Dashboard - **Multiple IdP support** - Configure Pocket ID, Auth0, Google, Microsoft, Okta, or any OIDC provider directly from the Dashboard - **New quickstart script** - Simpler deployment with fewer containers ```bash export NETBIRD_DOMAIN=netbird.example.com curl -fsSL https://github.com/netbirdio/netbird/releases/latest/download/getting-started.sh | bash ``` This is available for new installations and is fully backward-compatible—existing setups will continue to work without changes. The previous Zitadel quickstart script remains available. Learn more: - [Quickstart Guide](https://docs.netbird.io/selfhosted/selfhosted-quickstart) - [Identity Providers & Local User Management](https://docs.netbird.io/selfhosted/identity-providers) ##### Dashboard Enhancements - Added **instance setup wizard** for first-time user creation on new installations <img width="300" height="300" alt="image" src="https://github.com/user-attachments/assets/4f05dfe9-06cb-4563-b452-a6cf8a783987" /> - Added **user creation flow** with password generation and copy functionality - Added **Identity Providers settings tab** for configuring external IdPs directly from the UI <img width="300" height="300" alt="image" src="https://github.com/user-attachments/assets/c0a879b4-00f3-4d54-83d2-c039974934c5" /> <img width="300" height="300" alt="image" src="https://github.com/user-attachments/assets/86c4e944-a132-4f80-a803-43e6553f1c71" /> - Added **IdP badges** in user list showing each user's authentication source <img width="500" height="500" alt="image" src="https://github.com/user-attachments/assets/54096978-56d1-4a17-b7f0-7173b79d7d1a" /> ##### Related PRs - Added embedded identity provider for self-hosted deployments [netbird#5008](https://github.com/netbirdio/netbird/pull/5008) - Configure Identity Providers in the UI [dashboard#523](https://github.com/netbirdio/dashboard/pull/523) #### Client Enhancements - Fixed an issue where the client could get **stuck in connecting state** when `api.netbird.io` is unreachable. [#5033](https://github.com/netbirdio/netbird/pull/5033) - Added **port forwarding support** to the SSH proxy. [#5031](https://github.com/netbirdio/netbird/pull/5031) - Added support for **disabling the eBPF WireGuard proxy** via environment variable. [#5047](https://github.com/netbirdio/netbird/pull/5047) - Fixed **SSH UI flickering test** instability. [#5036](https://github.com/netbirdio/netbird/pull/5036) #### Management Improvements - Refactored **integrated peer validation** and **peer deletion** logic for better consistency. [#5035](https://github.com/netbirdio/netbird/pull/5035), [#5042](https://github.com/netbirdio/netbird/pull/5042) - Incremented **network serial on peer updates** to ensure correct synchronization. [#5051](https://github.com/netbirdio/netbird/pull/5051) - Fixed **nil handling for extra settings** in management. [#5049](https://github.com/netbirdio/netbird/pull/5049) - Cached **SSH authorized users** in the network map for improved performance. [#5048](https://github.com/netbirdio/netbird/pull/5048) #### Identity & Infrastructure - Introduced **Embedded IdP**, simplifying identity provider management across management, infrastructure, and IdP components. [#5008](https://github.com/netbirdio/netbird/pull/5008) #### Shared & Tooling Improvements - Added support for setting a **custom User-Agent** in the REST client. [#5037](https://github.com/netbirdio/netbird/pull/5037) - Fixed **ui-post-install.sh** to correctly use the full username. [#4809](https://github.com/netbirdio/netbird/pull/4809) - Improved **Nmap concurrency handling**. [#5040](https://github.com/netbirdio/netbird/pull/5040) ### New Contributors - @devurandom made their first contribution in [#4809](https://github.com/netbirdio/netbird/pull/4809) - @markcst for feedback contribution and a great discussion **Full Changelog**: [v0.61.2...v0.62.0](https://github.com/netbirdio/netbird/compare/v0.61.2...v0.62.0)