> For the complete documentation index, see [llms.txt](https://docs.ionos.com/cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ionos.com/cloud/backup-and-storage/backup-service/how-tos/update-agent-version.md).

# Update Agent Version

Keeping your Backup Agent up to date ensures compatibility with the latest <code class="expression">space.vars.backup\_service</code> platform features and avoids potential backup failures. The topic guides you through updating individual agents manually and configuring automatic updates for all machines.

## Update Agent version using Backup Service Console

Under its Managed Services offering, <code class="expression">space.vars.ionos\_cloud</code> regularly updates the entire <code class="expression">space.vars.backup\_service</code> platform and the corresponding Backup Agent. To avoid compatibility issues, we recommend regularly updating the Agent software on your VMs, workstations, or other backed-up devices. You can either use the **Backup Service Console** to update the agents individually or set an automatic update for all machines.

If your Agent is already set to automatically update during the default maintenance window, you have to take no further action. However, if you have disabled the automatic update option, you should arrange for your Agent to be updated either manually or during maintenance. Otherwise, the software might cause compatibility issues in the future.

{% hint style="info" %}
**Note:**

* To find the Agent version for a particular machine, under **All devices** select the machine, and then click on the **Details** icon. A tab will expand from the right, showing the device’s **Agent version**.
* In case any existing Acronis products or components are incompatible with the version you are going to install, uninstall the current Acronis Backup Agent and reinstall it.\
  For installation instructions, see:
  * [<mark style="color:blue;">Install Acronis Backup Agent on Linux</mark>](/cloud/backup-and-storage/backup-service/how-tos/install-acronis-backup-agent.md)
  * [<mark style="color:blue;">Install Acronis Cyber Protect Agent on Windows Server</mark>](/cloud/backup-and-storage/backup-service/how-tos/install-acronis-backup-agent-windows.md)
    {% endhint %}

{% hint style="info" %}
**Prerequisites:** Updating to a new version of the software requires VM disk space. Please ensure that you have at least 5 GB left on the VM volume, otherwise the update might fail.
{% endhint %}

## Update individual machines manually

When an Agent is out of date, the system will provide a small alert under **Settings**. The circled number shows how many **Agents** require updating.

{% stepper %}
{% step %}

## Navigate to the Backup Unit Manager

1\. In the **DCD**, go to **Menu** > **Backup & Storage** > **Backup Unit Manager**.

2\. Select the required backup unit and click **Open Console**.

3\. In the **Backup Service Console**, go to **Settings** > **Agents**. The software displays the list of machines. The machines with outdated agent versions are marked with an orange exclamation mark.
{% endstep %}

{% step %}

## Select and update the outdated agents

1\. Select the machines that you want to update the agents on. The machines must be online.

2\. Click **Update all outdated Agents** for all machines.

![Update agent or all outdated agents](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-a4f7b1e4ae42ee3ebabbf2aae58cbd2d30012dff%2Fbackup-service-update-manually.png?alt=media)
{% endstep %}

{% step %}

## Confirm the update

1\. In the Update agent window, click **Update**.

2\. You will be notified that the process has started. The selected machines will be updated with the current Agent version.

![Update agent](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-9d13df897fedac6f891d8b7e334f9a4fbf2bdf9c%2Fbackup-service-update-agent.png?alt=media)

{% hint style="info" %}
**Note:** During the update, any backups that are in progress will fail.
{% endhint %}
{% endstep %}

{% step %}

## View Agent settings and select machines

Alternatively, you can update all machines automatically.

1\. In the **Backup Service Console**, go to **Settings** > **Agents**. The software displays the list of machines. The machines with outdated agent versions are marked with an orange exclamation mark.

2\. Select the machines that you want to update the agents on. The machines must be online.
{% endstep %}

{% step %}

## Configure automatic updates

1\. Select the **Automatically update agents** option. This aligns the update with <code class="expression">space.vars.ionos\_cloud</code>’s regular maintenance.

2\. **Activate Maintenance window** and set a timeframe below.
{% endstep %}

{% step %}

## Save the schedule

1\. Click **Save**. The selected machines will be updated regularly with the current Agent version during the chosen timeframe.

![Update all agents automatically](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-6c01686e1bb2cbd145f792c0739cdab1a4e157cd%2Fbackup-service-update-all-agents.png?alt=media)
{% endstep %}
{% endstepper %}

{% hint style="success" %}
**Result:** The Backup Agent on the selected machines is updated to the current version, either immediately or automatically during the configured maintenance window.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ionos.com/cloud/backup-and-storage/backup-service/how-tos/update-agent-version.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
