> For the complete documentation index, see [llms.txt](https://docs.duplicati.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.duplicati.com/duplicati-console/the-machine-list.md).

# The machine list

This page describes the Machines tab in the Duplicati Console, where the connected machines are listed, approved, licensed, tagged and managed.

The [**Machines** tab](https://app.duplicati.com/app/machines) lists every machine that is connected to the current organization, with its status, the last backup and the actions that apply to it. This is the starting point for day-to-day management of the connected machines.

The page has four tabs:

* **Machines**, the list described on this page.
* **Links**, where the [connection links](https://docs.duplicati.com/duplicati-console/connecting-to-the-duplicati-console.md#connect-with-a-link) for registering new machines are managed.
* **Configurations**, where [backup configurations](https://docs.duplicati.com/duplicati-console/backup-configurations.md) are created and pushed to machines. Requires an Enterprise subscription.
* **Managed backups**, where [managed backups](https://docs.duplicati.com/duplicati-console/managed-backups.md) of Microsoft 365 and Google Workspace are set up.

The **Configurations** and **Managed backups** tabs are hidden for organizations with [confidential processing](https://docs.duplicati.com/duplicati-console/confidential-processing.md).

<figure><picture><source srcset="https://2363712449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cMJiGuXy340g9NzpxLY%2Fuploads%2Fgit-blob-2852ea4abe7bb1937fea51a231c35fcfe74870de%2Fconsole-machines-list-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://2363712449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7cMJiGuXy340g9NzpxLY%2Fuploads%2Fgit-blob-f5a4c303c16282407bf9be39556625578a4efb26%2Fconsole-machines-list-light.png?alt=media" alt="The Machines tab with the license and online cards, the filters and the list of machines"></picture><figcaption></figcaption></figure>

## Overview cards

At the top of the page, the **Licenses** card shows how many of the machine licenses on the subscription are in use, and the **Online** card shows how many machines are connected right now. If the organization has connection links, the links are listed next to the cards, and clicking a link copies it so it can be pasted into a client.

## The list

Each row is a machine. The columns can be turned on and off with the **Columns** menu, and the selection is remembered in the browser:

| Column            | Description                                                                                                                                                                                                                                                                                                                                                             |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Machine Name      | The name of the machine. Click the pen to rename it in the console. The name on the machine itself is not changed. The machine id is shown when hovering the name.                                                                                                                                                                                                      |
| Organization      | The organization the machine belongs to. Only useful with **Show all organizations**, and hidden by default.                                                                                                                                                                                                                                                            |
| Tags              | The [tags](#tags) on the machine.                                                                                                                                                                                                                                                                                                                                       |
| Status            | The result of the latest report from each backup on the machine, as colored indicators.                                                                                                                                                                                                                                                                                 |
| Last Online       | "Online now" for a connected machine, otherwise how long ago it was last seen.                                                                                                                                                                                                                                                                                          |
| Last Backup       | How long ago a backup last completed on the machine. The value is marked when the last backup is more than 7 days old, and marked again when it is more than 30 days old. While a backup is running, a progress bar is shown instead.                                                                                                                                   |
| Last Restore Test | How long ago a [restore test](https://docs.duplicati.com/duplicati-console/restore-test-policies.md) last passed, or how many backups on the machine are overdue for one. Hidden by default.                                                                                                                                                                            |
| Source            | The size of the source data, summed over the backups on the machine.                                                                                                                                                                                                                                                                                                    |
| Destination       | The size of the data at the destinations, summed over the backups on the machine.                                                                                                                                                                                                                                                                                       |
| Assigned Backups  | The [backup configurations](https://docs.duplicati.com/duplicati-console/backup-configurations.md) that are pushed to the machine. A configuration that is not applied because of a [missing variable](https://docs.duplicati.com/duplicati-console/backup-configurations/machine-variables.md#when-a-variable-is-missing) is marked with a warning. Hidden by default. |
| Version           | The Duplicati version and release channel on the machine. The value is marked when a newer version is available. Managed backup runners show "latest".                                                                                                                                                                                                                  |
| License           | Whether the machine has a machine license. Machines with Microsoft 365 or Google Workspace seats show the number of seats as well.                                                                                                                                                                                                                                      |

The arrow at the end of each row opens the machine, with the backups on it and their reports.

### Finding machines

The search field matches the machine name. The **Sort** menu orders the list by last online, last backup, name, license, or the source or destination size. The **Status** menu keeps only machines where the latest backup report has the chosen result, and the **Tags** menu keeps only machines with one of the chosen tags. The **Variables** menu with **Missing** keeps only machines with a backup configuration that is not applied because of a [missing variable](https://docs.duplicati.com/duplicati-console/backup-configurations/machine-variables.md#when-a-variable-is-missing).

If the organization has sub-organizations, **Show all organizations** adds the machines from the sub-organizations to the list. Actions that need a connection to the machine, such as **Start Session**, are only available for machines in the current organization, so switch to the sub-organization for those.

### Tags

Tags are labels that you define yourself, such as a location, a department or a customer, and they are used to filter the list. Click **Add tags** on a machine, or the tags it already has, to open the tag menu. Check a tag to add it to the machine, and type a name that does not exist yet to create a new tag. The menu next to each tag renames it, changes its color or deletes it from all machines.

Tags belong to the organization, and the same tags are available on every machine in it.

## Machine actions

The **Details** menu at the end of each row holds the actions for the machine. Which actions are shown depends on the state of the machine and the subscription.

### Approving and licensing

A machine needs a machine license to be monitored and to receive configurations. When a machine registers, it normally gets a license right away, as long as there are free licenses on the subscription.

| Action          | Description                                                                                                                                                                                                                                                          |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Approve Machine | Shown for a machine that registered with a link that [requires manual approval](https://docs.duplicati.com/duplicati-console/connecting-to-the-duplicati-console.md#link-options). Gives the machine a license, and the configurations on the link are pushed to it. |
| Grant License   | Gives a license to a machine that has none, for instance after the license was revoked or when no license was free at the time it registered.                                                                                                                        |
| Revoke License  | Takes the license away from the machine, so it frees a license for another machine. The machine stays connected and in the list, but is no longer monitored, and the configurations that were pushed to it are removed from it.                                      |
| Delete Machine  | Revokes the license and removes the machine from the console. The machine must be registered again to come back, and the connection must be removed on the machine as well, or it will keep trying to connect.                                                       |

Deleting a machine does not delete any backups or backup data. The backup reports that the machine sent are deleted from the console, together with the notifications about them.

### Working with the machine

| Action                | Description                                                                                                                                                                                                                                                                                                                                                            |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Start Session         | Opens the local Duplicati user interface of the machine in the console, so the machine can be managed as if you were sitting at it. The machine must be online.                                                                                                                                                                                                        |
| Run Restore Test      | Starts a [restore test](https://docs.duplicati.com/duplicati-console/restore-test-policies.md) of every backup on the machine. The machine must be online and run Duplicati 2.4.1.0 or newer.                                                                                                                                                                          |
| Assign Backups        | Chooses which [backup configurations](https://docs.duplicati.com/duplicati-console/backup-configurations.md) the machine should have. Requires an Enterprise subscription.                                                                                                                                                                                             |
| Variables             | Sets the [machine variables](https://docs.duplicati.com/duplicati-console/backup-configurations/machine-variables.md) that are filled into the backup configurations for this machine. Requires an Enterprise subscription.                                                                                                                                            |
| Assign Cloud Seats    | Issues Microsoft 365 and Google Workspace seats to the machine, so it can run its own [Microsoft 365](https://docs.duplicati.com/automation-and-integration/office-365-backup-and-restore.md) or [Google Workspace](https://docs.duplicati.com/automation-and-integration/google-workspace-backup-and-restore.md) backups. Shown when the subscription has such seats. |
| Enable Reporting      | Asks the machine to send its backup reports to the console. **Disable Reporting** stops them again. Reporting is normally turned on by the connection link.                                                                                                                                                                                                            |
| Issue Storage API Key | Gives the machine a key for [Duplicati Storage](https://docs.duplicati.com/duplicati-console/duplicati-storage.md). **Rotate Storage API Key** replaces the key, and **Revoke Storage API Key** removes it, so the machine can no longer reach the storage.                                                                                                            |

For a managed backup runner, the only action is **Rotate Storage API Key**, since the runner is managed from the [Managed backups](https://docs.duplicati.com/duplicati-console/managed-backups.md) tab.

{% hint style="info" %}
Backups from a client that is too old to report a machine id are grouped under a machine named **UNKNOWN**. Update the client to have the backups appear under the right machine.
{% 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.duplicati.com/duplicati-console/the-machine-list.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
