mirror of
https://github.com/netbirdio/docs.git
synced 2026-04-16 07:26:35 +00:00
Extend the auto update feature with force flag (#653)
This commit is contained in:
@@ -1,8 +1,8 @@
|
|||||||
import {Note} from "@/components/mdx";
|
import {Note, Warning} from "@/components/mdx";
|
||||||
|
|
||||||
# Client Automatic Updates
|
# 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.
|
||||||
|
|
||||||
<Note>
|
<Note>
|
||||||
Minimum supported agent version: <strong>v0.61.0</strong>.
|
Minimum supported agent version: <strong>v0.61.0</strong>.
|
||||||
@@ -30,19 +30,29 @@ You can either:
|
|||||||
* Update to a specific version.
|
* Update to a specific version.
|
||||||
|
|
||||||
<Note>
|
<Note>
|
||||||
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.
|
||||||
</Note>
|
</Note>
|
||||||
|
|
||||||
|
### 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.
|
||||||
|
|
||||||
|
<Warning>
|
||||||
|
Enabling Force Automatic Updates will restart the NetBird client during updates, which can temporarily disrupt active connections. Use with caution in production environments.
|
||||||
|
</Warning>
|
||||||
|
|
||||||
|
|
||||||
## How it works
|
## How it works
|
||||||
|
|
||||||
1. **User-Initiated Connection**: When a Peer connects to Management, it will receive the current Automatic Updates settings.
|
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.
|
2. **Version Check**: The Peer will compare its current version with the version specified in the Automatic Updates settings.
|
||||||
3. **Update Process**:
|
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.
|
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.
|
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
|
## Supported Platforms
|
||||||
|
|
||||||
Automatic Updates are supported on the following platforms only:
|
Automatic Updates are supported on the following platforms only:
|
||||||
|
|||||||
Reference in New Issue
Block a user