From e211d58b2a73fde941f72d87ccca0e5b5b4d1640 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Zolt=C3=A1n=20Papp?= Date: Fri, 13 Mar 2026 11:15:37 +0100 Subject: [PATCH] Extend the auto update feature with force flag --- src/pages/manage/peers/auto-update.mdx | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/src/pages/manage/peers/auto-update.mdx b/src/pages/manage/peers/auto-update.mdx index 6a3a9e653..1e5460e97 100644 --- a/src/pages/manage/peers/auto-update.mdx +++ b/src/pages/manage/peers/auto-update.mdx @@ -1,8 +1,8 @@ -import {Note} from "@/components/mdx"; +import {Note, Warning} from "@/components/mdx"; # Client Automatic Updates -The Automatic Updates feature allows the NetBird client to automatically update itself when a new version is available. This ensures that users always have the latest features and security patches without needing to manually download and install updates. +The Automatic Updates feature allows the NetBird client to notify users when a new version is available and prompt them to install it. This ensures that users always have the latest features and security patches without needing to manually download and install updates. Minimum supported agent version: v0.61.0. @@ -30,19 +30,29 @@ You can either: * Update to a specific version. - Once enabled, NetBird clients will automatically check for updates when connecting via the UI and install the specified version if the current version is older than the specified version. + Once enabled, NetBird clients will prompt the user to install the specified version when connecting via the UI, if the current version is older than the specified version. +### Force Automatic Updates + +When you need updates to be installed without user interaction, enable the **Force Automatic Updates** toggle. With this option, updates are installed automatically in the background without prompting the user. + + + Enabling Force Automatic Updates will restart the NetBird client during updates, which can temporarily disrupt active connections. Use with caution in production environments. + + ## How it works 1. **User-Initiated Connection**: When a Peer connects to Management, it will receive the current Automatic Updates settings. 2. **Version Check**: The Peer will compare its current version with the version specified in the Automatic Updates settings. 3. **Update Process**: - 1. If the Peer is running an older version than specified, it will show a notification to the user indicating that an Automatic Update is under way. + 1. If the Peer is running an older version than specified, it will prompt the user to install the update. 2. Client will then download the update package from the official NetBird repository. 3. The Peer will then install the update and restart itself to apply the changes. +When **Force Automatic Updates** is enabled, step 3.1 is skipped, the update is installed automatically in the background without user interaction. + ## Supported Platforms Automatic Updates are supported on the following platforms only: