Uninstalling the Datto Endpoint Backup v2 Linux agent

Module: Endpoint Backup v2

This article describes how to remove the Datto Backup Agent from a protected Linux asset.

Removing an asset from protection has two separate parts, and you usually want both:

  • Uninstall the agent software from the machine, which stops new backups.
  • Remove the asset from UniView, which releases its license.

IMPORTANT  Uninstalling the agent does not release the asset's license.
If you leave the asset in UniView, it continues to consume a license.

Choose an uninstall method

How you uninstall determines whether you can resume the existing backup chain later.

Method Use it when
Standard uninstall You may want to protect this machine again later.
Reinstalling the agent lets you resume the existing backup chain.
Complete removal You are retiring the machine or need a clean state for troubleshooting.
This is irreversible: a future installation starts a new backup chain.

Uninstall the agent

Remove the agent with your distribution's package manager.
The agent package is named datto-backup-agent. Removing it stops the agent service, the updater service, and the updater's timer before it deletes them, so you do not need to stop the agent first.

On Ubuntu and Debian, run:

sudo apt remove datto-backup-agent

On Rocky Linux, AlmaLinux, Oracle Linux, and Red Hat Enterprise Linux, run:

sudo dnf remove datto-backup-agent

The agent stops running and no further backups are taken for the asset.

NOTE  Uninstalling with the built-in uninstaller leaves the agent's local data in place.
If you reinstall the agent on the same machine, you can resume the existing backup chain.

Remove the agent completely

To remove the agent without the possibility of resuming the existing backup chain, also delete the agent's local data directories after you uninstall the package:

sudo rm -rf /opt/datto-backup-agent /var/lib/datto-backup-agent "/var/cache/Datto Backup Agent"

Deleting /opt/datto-backup-agent removes the agent's settings, its logs, and the keychain file that holds your customer-managed encryption key, if you supplied one.
If you keep the folder and reinstall the agent later, the agent reuses those settings and keys unless you install with CLEAN_INSTALL=1.

NOTE  This method is irreversible.
If you protect the same machine again later, the agent registers as a new asset and starts a new backup chain.

Removing DattoBD

On distributions that require it, the agent package installs the DattoBD kernel module as a dependency.

IMPORTANT  If the machine also runs the Datto Linux Agent for SIRIS, leave DattoBD installed. That agent uses the same kernel module.

On Ubuntu and Debian, removing the agent leaves DattoBD in place. To remove it, run:

sudo apt autoremove

On Rocky Linux, AlmaLinux, Oracle Linux, and Red Hat Enterprise Linux, dnf remove removes DattoBD together with the agent when nothing else depends on it.

Restart the machine to unload the module from the running kernel.

Remove the asset from UniView

Uninstalling the agent leaves the asset listed in UniView, where it continues to consume a license.
Delete the asset to release its license.

To remove the asset, follow the steps in How to delete an asset.

IMPORTANT  Check the selected count before you delete.
Filtering the asset table does not clear your selection, so the assets you are about to remove may not all be visible.

What happens to your backups

Uninstalling the agent does not delete any recovery points.

Retention continues to run against those recovery points on the schedule set by the asset's assigned policy, so they keep aging out over time even though no new backups are being taken.
See Understanding retention in Datto Endpoint Backup v2 for more information on how the retention tiers work.

Related topics