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)