Cloud updates
You can update agents remotely via the Mutexer Cloud environment. Use this method when the device is online and you want the platform to trigger the update without running commands on the device terminal.
Prerequisites
Before starting a cloud update, confirm the following:
| Requirement | Description |
|---|---|
| Device access | You can access the device in the Mutexer Cloud project. |
| Agent connectivity | The device is online and the agent has authenticated recently. |
| Agent version | The installed agent version is greater than 1.0.20. Agents running version 1.0.20 or earlier must be updated manually. For more information, see Manual updates. |
| Update availability | The Agent page shows an available agent update. |
If the device is offline, the cloud update cannot start until the device reconnects.
How to update from the cloud
Open the Agent page
Sign in to the Mutexer Cloud.
Open the project that contains the device.
In the device tree, expand Devices.
Select the target device.
Open Agent.
The Agent page shows the current agent status, installed version, architecture, and last authentication time.
Review the available update
When an update is available, the Agent version section shows the current version and target version.
For example:
v0.0.152 -> v0.0.153 (amd64 - 05 May 2026)Review the following values before starting the update:
| Field | Description |
|---|---|
| Current version | The agent version currently installed on the device. |
| Target version | The agent version that will be installed. |
| Architecture | The device architecture selected for the update. |
| Release date | The publication date for the target version. |
Use the release tabs to review release notes, installation instructions, revision history, and artifact checksums before updating.
Start the update
To start the update, choose Update in the Agent version section.
The Mutexer Cloud sends an update request to the agent. The agent downloads and applies the target version for the device architecture.
WARNING
The update temporarily stops the agent. During this time, WireGuard connectivity and telemetry can be interrupted. Programs and operating system processes continue to run unless they depend directly on an agent-managed service.
Download the agent artifact
The Agent version section can also provide a download button for the detected architecture, such as Download amd64.
Use this option when you need to download the same artifact manually. Before using a manually downloaded artifact, verify its checksum. For more information, see Verifying Integrity.
Verify the result
After the update completes, confirm that the Agent page shows the expected installed version.
You can also verify the version from the device command line:
cd /opt/mutexer/agent
sudo ./agent versionIf the version does not change, review the device connection state and agent logs. For more information, see Logging.