Manual updates

Manual updates update an existing agent outside the Mutexer Platform user interface. You can update to the latest published version or download a specific version from the Agent Releases page.

For release selection and version metadata, see Updating.

Update to the latest version

To update an existing agent to the latest published version, run the update command as the root user:

cd ~ && curl -s https://get.mutexer.com/api/agents/upgrade-agent -o o.sh && chmod +x o.sh && ./o.sh && rm -rf o.sh

The update process preserves the device identity, WireGuard keys, and agent-managed autostart container state.

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 a specific version

1. Open the Agent Releases page:

   https://www.mutexer.com/agent-versions

2. Select the required version.

3. On the release page, select Download Agent.

4. Select the correct architecture for the device.

5. Download the file directly, or copy the provided curl command and run it on the target device.

6. Verify the downloaded file before using it. For more information, see Verifying Integrity.

Fresh installs require the device-specific install command generated by the Mutexer Platform. Do not use a manually downloaded agent binary as a substitute for the device connection command unless Mutexer Support instructs you to do so.

Select the correct architecture

Agent downloads are architecture-specific.

Device architecture	Agent architecture
x86_64	amd64
aarch64	arm64
armv7l	armv7

To check the device architecture, run:

uname -m

Download the agent binary that matches the device architecture.

WARNING

Do not install an agent binary for a different architecture. The binary might fail to start or produce undefined behavior.

Review version metadata

Before using a manually downloaded version, review the version-specific release page.

Confirm the following values:

Field	Description
Version	The exact agent version to download.
Update requirement	Whether the update is required or optional.
Reboot requirement	Whether the device must be rebooted after the update.
Architecture	The processor architecture for the downloaded binary.
Checksums	The published MD5 and SHA-256 values for the selected binary.

If the release requires a reboot, schedule the update during a maintenance window.