Agent Settings

Agent Settings gives you a central view of your device's agent. It shows the current status, installed capabilities, deployed applications, and version. You can start or stop applications, update the agent, and manage re-licensing or reinstallation from this page.

Open Agent Settings by clicking Manage on a device in the Device treeview:

Devices > Your Device > Agent

The page is organised into three tabs.

Overview

The Overview tab shows the health of your device's agent at a glance.

Status cards

• Status: Whether the agent is currently running or offline
• Version: The installed agent version and architecture, with a badge indicating whether an update is available
• Last authenticated: The date and time the agent last connected to the platform. If the agent has never authenticated, this card shows that message instead

Capabilities

Capabilities are optional features that extend what your agent can do. Your device displays an install tier badge:

• Core: The hardened base runtime with Deployment, Logging, Device control, and Horizon Zero Trust always included
• Advanced: Core plus every available capability
• Custom: Any partial combination of capabilities

Each capability shows its current state:

• Not installed: The feature is not present on this device
• Enrolling: The feature has been installed and is still establishing its connection
• On: The feature is active and ready to use

To change the capability tier, you need to reinstall the agent and select a different install type. For more information, see Capabilities.

Device Connection

This section lets you manage your device's ongoing connection to the platform.

• Re-license: Renew or transfer the agent licence for this device
• Reinstall: Reinstall the agent while preserving your device identity and installed capabilities

A status message at the bottom tells you whether the device is connected and ready ("Your device is connected and ready to use") or waiting for a connection.

Applications

The Applications tab lists every containerised application deployed on this device.

• Application: The name of the deployed application
• Status: The current state: Running, Stopped, Paused, Error, Deploying, Not deployed, and others
• Actions: Click the more-menu icon (⋮) next to a running or stopped application to open a menu with these options
  • Start: Start a stopped application
  • Stop: Stop a running application
  • Remove: Remove the application from this device

If no applications are deployed yet, the table shows "No applications deployed yet."

Version

The Version tab manages the agent software itself. It shows the currently installed version, compares it against the latest release, and lets you upgrade in place.

Key information

• Version: Compares your installed version with the latest available
• Upgrade requirement: Indicates whether an update is recommended or required
• Release date: When the latest version was published
• Reboot requirement: Whether a reboot is needed after updating
• Type: The agent runtime type and capability variant (for example, base+cloudlink). For more information, see Variant names

Actions

• Update Agent: Sends an update command to the agent over the platform connection. The agent restarts automatically and reconnects on the new version. This button is disabled while the agent is offline, and on agents earlier than 1.0.24, which must be updated by running the update command on the device
• Download Agent: Opens the download page for the latest agent build in a new tab, so you can install it manually from the device terminal

Release details

Click through the sub-tabs under Version to find more information:

• Release Notes: Summary and full notes for the latest release, plus artefact checksums (MD5 and SHA-256) that you can copy to verify a download before installing
• Enhancements: New features included in this release
• Fixes: Bugs resolved in this release
• Installation Instructions: A manual upgrade command for devices where the remote update is unavailable, plus instructions for checking the agent version via the terminal and system requirements
• Revision History: A paginated list of all published agent versions with their release dates, summaries, and whether each version is installed or end-of-life

Manual upgrade (terminal)

If your agent is too old to support remote updates, you can upgrade manually from the device terminal:

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 upgrade preserves your device identity, CloudLink (WireGuard) keys where applicable, and autostart container state.

To check the agent version after upgrading:

cd /opt/mutexer/agent
sudo ./agent version