sendnrw/netbird-docs
2
0
Fork 0
mirror of https://github.com/netbirdio/docs.git synced 2026-10-03 04:09:04 +02:00
Code Issues Packages Projects Releases Wiki Activity

Updates for the NetBird 0.75 update (#881)

Browse Source
This commit is contained in:
PizzaLovingNerd
2026-07-24 07:43:56 -07:00
committed by GitHub
parent f6ee418c4b
commit b867aa85c8
32 changed files with 303 additions and 269 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/pages/get-started/install/windows.mdx
+5 -16
View File
@@ -16,7 +16,7 @@ The NetBird client (agent) allows a peer to join a pre-existing NetBird deployme
## Silent and Automated Installation
Both installers support silent (unattended) installation for use with RMM tools, MDM platforms, and scripted deployments. By default, silent installations automatically configure the NetBird UI to start at user login, so the system tray icon is available without manual intervention.
Both installers support silent (unattended) installation for use with RMM tools, MDM platforms, and scripted deployments.
### EXE Installer (NSIS)
@@ -26,7 +26,7 @@ Run the EXE installer with the `/S` flag for a silent installation:
netbird_installer_<VERSION>_windows_amd64.exe /S
```
The UI tray autostart is enabled by default for both interactive and silent installs. The installer writes the autostart entry to `HKLM\Software\Microsoft\Windows\CurrentVersion\Run`, which applies to all users on the machine.
The installer no longer writes a machine-wide `HKLM\Software\Microsoft\Windows\CurrentVersion\Run` entry. Starting with v0.75.0, the desktop app manages launch at login as a per-user preference.
### MSI Installer
@@ -36,16 +36,10 @@ Run the MSI installer with `msiexec` for a silent installation:
msiexec /i netbird_installer_<VERSION>_windows_amd64.msi /quiet
```
The MSI installer includes an `AUTOSTART` property that defaults to `1` (enabled). When enabled, it registers `netbird-ui.exe` in `HKLM\Software\Microsoft\Windows\CurrentVersion\Run` so the UI tray starts automatically at login for all users.
To disable the UI tray autostart during installation:
```bash
msiexec /i netbird_installer_<VERSION>_windows_amd64.msi AUTOSTART=0 /quiet
```
The MSI does not expose an `AUTOSTART` property. On a fresh desktop installation, the app enables **Launch NetBird UI at Login** for the current user the first time the UI runs. Upgrades preserve the user's existing preference. Users can change it under **Settings → General**, and administrators can suppress or remove the per-user registration with the [`disableAutostart` MDM setting](/client/mdm-integration#disableAutostart).
<Note>
Disabling `AUTOSTART` only prevents the UI tray from launching at login. The NetBird background service still runs and maintains connectivity regardless of this setting.
**Launch NetBird UI at Login** affects only the graphical interface. The NetBird background service starts independently and can maintain connectivity even when the UI does not launch.
</Note>
### Combining with a Setup Key
@@ -70,12 +64,7 @@ netbird up --setup-key <SETUP KEY>
## Running NetBird with SSO Login
### Desktop UI Application
If you installed the Desktop UI client, you can launch it and click on Connect.
> It will open your browser, and you will be prompt for email and password. Follow the instructions.
<p>
<img src="/docs-static/img/get-started/netbird-sso-login-ui.gif" alt="high-level-dia" className="imagewrapper-big"/>
</p>
Launch the desktop app and click **Connect** in the main window or system-tray menu. On first launch, choose NetBird Cloud or enter the URL of your self-hosted deployment. NetBird opens your browser to authenticate the device. See the [desktop app guide](/client/desktop-app) for the complete interface.
### CLI
Alternatively, you could use command line. Simply run