How do I troubleshoot VMDK File Not Found Errors?



On attempting to pair a server by using a hypervisor connection with your Datto backup appliance, or when attempting to perform a backup of a system protected with the agentless backup solution, the error Critical backup failure: VMDK file not found: /home/agents/vm-vmname/vm.vmdk. Check if VM mount succeeded displays.


  • Datto SIRIS
  • Agentless backups


These failures apply to agentless backups, and can be caused by ESXi failing to resolve a VM's address by hostname. Finding the VM is the first step of the backup process. The vddk-fuse process then mounts the snapshot from the VMWare environment for network transfer to the Datto device.

This error can also be caused by independent disks being attached to the VM. Independent disks are not affected by VMware snapshots, and the VMDK 'file not found' error can occur during pairing.

If the datastore name in VMware contains non-ASCII characters, agents may fail to pair with this error.


To resolve this error, make sure that there is an internal DNS entry on the Configure → Networking tab of the web UI, as shown in Figure 1.

Figure 1: Configure → Networking

Make sure internal DNS entries are listed above the public entries, as shown in Figure 2:

Figure 2: DNS Servers

If the agent contains non-ASCII characters, rename the agent to ensure it does not.

If you are still unable to pair the protected agent or resume backups, add the Datto device to your domain via the Configure → Networking tab of the GUI. Then, test communication to the target VM again. This step only allows you to confirm that internal DNS troubleshooting is necessary; you should not leave the device on the domain after troubleshooting.

Was this article helpful?

1 out of 4 found this helpful

You must sign in before voting on this article.

Want to talk about it? Have a feature request?

Head on over to our Community Forum or get live help.

For more Business Management resources, see the Datto RMM Online Help and the Autotask PSA Online Help .

Datto Homepage