> 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/~/revisions/NfgM5VQuRjXRMfbR25yK/storage-and-backup/backup-service/how-tos/update-agent-version.md).

# Update Agent Version

### Updating Agent versions via the Backup Service Console

Under its Managed Services offering, IONOS Cloud regularly updates the entire Backup service 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 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**.
{% endhint %}

### Updating individual machines manually

{% 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 %}

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.

1. In the **DCD**, go to **Storage** > **Backup Console**, and log in to one of the backup consoles in the list.
2. In the backup 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.
3. Select the machines that you want to update the agents on. The machines must be online.
4. Click **Update Agent** for an individual machine or **Update all outdated Agents** for all machines.

![](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-6f0e2a6406906acba26196854c1a5153c2eae3ae%2Fupdate_manually.png?alt=media)

5. In the Update agent window, click **Update**.
6. You will be notified that the process has started. The selected machines will be updated with the current Agent version.

![](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-1f38173611f7328d58239b4bb95bab8dd2245460%2Fupdate.png?alt=media)

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

### Update all machines automatically

1. In the Backup Service web 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.
3. Activate the **Automatically update agents** tab. This aligns the update with IONOS Cloud’s regular maintenance.
4. **Activate Maintenance window** and set a timeframe below.
5. Click **Apply**. The selected machines will be updated regularly with the current Agent version during the chosen timeframe.

![](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-131cd381c14cca1de8911e33dcc18c8ee666513e%2Fupdate_all_agents.png?alt=media)


---

# 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/~/revisions/NfgM5VQuRjXRMfbR25yK/storage-and-backup/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.