Auto-update is available on Cloud deployments only.
Before you enable auto-update, please ensure you have set up the Antivirus Exclusions (at least the Temporary Exclusions) to avoid any issues with your antivirus software.
Introduction
The Auto-update feature allows you to create update channels that you can assign to computers for automatically updating them to the desired Agent versions, on a scheduled basis.
An update channel functions as a named auto-update policy: every computer belongs to exactly one channel, which determines the specific Agent version to deploy and the schedule for the update.
How auto-update then works day to day:
Agents check for updates at login and then periodically (roughly every 10-15 minutes), and only update inside the channel's scheduled days and window.
Rollout is gradual and load-balanced: update requests are intentionally throttled, so a large fleet can take from a few hours to a few days to fully update. This is normal.
A computer that is offline during its window simply tries again at the next scheduled period.
Unless disabled during Agent installation or in the Agent's config file, an Agent will update itself based on the update channel settings defined on the Dashboard. Disabling automatic updates during installation or in the config file prevents the Agent from checking for updates at all.
Method 1: Via the Dashboard
1. From the Computers dashboard, click the Open the Dashboard Actions menu (⋮) in the top-right corner.
2. Select Agent update channels. The Auto-update channels panel will open. It lists every channel with its schedule, version policy, and the number of computers assigned to it:
3. Click + Create channel to create a new channel.
4. Click the Edit button to edit an existing channel. Editing a channel is similar to creating a new channel.
5. Click the Delete button to delete a channel.
Creating/Editing A Channel
1. Enter a Name (e.g., "My Update").
2. Under Days, check the days updates are allowed.
3. Set the From / To time window.
4. Check Auto-update to the latest version to always install the newest agent release. Or, keep it unchecked and use the Windows, Windows on Arm, and Mac dropdowns to pin a specific version per platform.
5. Click Save.
Note: Update schedules are evaluated in UTC, not the computer's local time.
Deleting A Channel
Click Delete from the Auto-update channels panel to remove a channel. Computers on a deleted channel fall back to the Default channel. The Default channel itself cannot be deleted.
Assigning Computers to a Channel
Multiple Computers (Bulk Assignment):
1. On the Computers dashboard, select the computers using the Checkboxes.
2. Click the Actions button.
3. Select Change update channel. The Confirm bulk action dialog will open which shows how many computers will be affected by the channel:
4. Select the target channel from the Update channel dropdown list. Select Default to move computers back to the default channel. Note that non-default channels are supported only in specific Agent versions (as listed in the dialog).
5. Click Apply.
Single Computer:
1. On the Computers dashboard, select a computer to open its details page. Then, click the Edit button.
2. Select the desired channel from the Update channel dropdown list.
3. Click the Save button.
Via Installation/Configuration File Parameters
You can also enable/disable auto-update via installation/configuration file parameters.
Unless disabled during the Agent installation or in the Agent's config file, an Agent will update itself based on the update channel settings defined on the Dashboard. Disabling automatic updates during installation or in the Agent config file will prevent the Agent from checking for updates.
Windows
Via the Installation Parameters
You can enable/disable auto-update when installing the Agent by adding the TMDISABLEAUTOUPDATE=0 or TMDISABLEAUTOUPDATE=1 command line parameter to the file name. Where, 0 means enable, 1 means disable. For example, to enable auto-update, use the following command:
msiexec /i teramind_agent_v0.1.249_x86.msi TMDISABLEAUTOUPDATE=0
To disable auto-update, use the command below:
curl teramind_agent_v1.235-d(1).pkg | sudo bash -
Via the Configuration File
For an existing Agent installation, you can change the Agent configuration file to enable/disable auto-update. The configuration file is usually located at this location:
The config file is usually located in the following locations:
Hidden Agent:
C:\ProgramData\{4CEC2908-5CE4-48F0-A717-8FC833D8017A}\configRevealed Agent:
C:\ProgramData\Teramind Agent\config
Here, <agent version> is the Agent version, for example, 20.0.1084. <guid> is the globally unique identifier of the Agent. For example, {551DD8F9-2009-4565-B57B-1390B7DA6AF0}. Check out this Knowledge Base article to learn how to find your Agent version.
To enable the auto-update, add this line to the agent.conf file:
disable-autoupdate=1
Alternatively, you can just remove the disable-autoupdate line entirely to enable auto-update.
To disable auto-update, add this line:
disable-autoupdate=0
Mac
Via the Installation Parameters
You can enable/disable auto-update when installing the Agent by adding the -d(0) or -d(1) command line parameter to the file name. Where, 0 means enable, 1 means disable. For example, to enable auto-update, use the following command:
curl teramind_agent_v1.235-d(0).pkg | sudo bash –
To disable auto-update, use the command below:
curl teramind_agent_v1.235-d(1).pkg | sudo bash -
Via the Configuration File
For an existing Agent installation, you can change the Agent configuration file to enable/disable auto-update. The configuration file is usually located at this location: /usr/local/teramind/agent/etc/agent.conf).
To enable the auto-update, add this line to the agent.conf file:
disable-autoupdate=0
Alternatively, you can just remove the disable-autoupdate line entirely to enable auto-update.
To disable auto-update, add this line:
disable-autoupdate=1
How the Two Methods Interact
The configuration file is the override: an Agent with
disable-autoupdate=1never checks for updates, even if its channel says "Latest version".The dashboard channel is the policy: an Agent with updates enabled locally still only updates according to its channel - which version, on which days, in which window.
So to enable auto-update for a computer, both sides must allow it: the config file must not disable it, and its channel must permit updates. To disable auto-update, either set Do not update on the channel (fleet-wide, reversible from the dashboard) or use
disable-autoupdate=1/TMDISABLEAUTOUPDATE=1(per machine, survives dashboard changes).