Skip to main content
Version: DPX 4.16

🆕 Proxmox Restore

Proxmox Restore restores virtual machines protected by a Proxmox backup job to a Proxmox VE node. A single restore job can include virtual machines backed up by different Proxmox VE backup jobs, and you can choose the order in which the machines are restored.

Restrictions.

Proxmox restore is only supported in the web interface. Only virtual machines with an active recovery point from a Proxmox Backup can be selected.

Creating a Proxmox Restore Job​

  1. Go to Job Manager in the sidebar.
  2. Click New Restore Job to open the New Restore dialog window.

[image expected here]

  1. Select Proxmox Restore and click Next.

[image expected here]

  1. The initial Objects to Restore view is empty. Click Add virtual machines to open the virtual machine selection dialog.

[image expected here]

  1. The Add Virtual Machines dialog lists all virtual machines with an active recovery point from a Proxmox backup job, along with their source node and the backup job that protects them. Use + Add Filter to narrow down the list if needed.
    Select the virtual machines you want to restore and click Add.
Note.

The Selected items counter in the lower left corner shows how many items are selected in the current view.

[image expected here]

  1. The Objects to Restore view is populated with the selected virtual machines. Use the Backup Date/Time column to select which recovery point to restore for each machine. By default, the latest recovery point is selected.
Tip.

If you select Latest, the restore job always uses the most recent recovery point available at the time the job runs, even if it was created after the restore job was defined. Selecting a specific date and time instead pins the job to that recovery point.

[image expected here]

If you need to add more virtual machines later, click Add virtual machines again; the newly selected machines are appended to the list.

Setting the Restore Order​

For optimized performance, virtual machines are restored one at a time rather than simultaneously. The order of the machines in the Objects to Restore list is the order in which they will be restored. Arrange the list as needed, then click Next.

Tip.

Select multiple rows by holding Ctrl to add individual rows to the selection, or Shift to select a range. Click outside the list to deselect all.

Drag and Drop​

Drag and drop rows by pulling the [x] symbol up or down. If multiple rows are selected, only the dragged row appears as moving, with a badge showing how many additional rows move with it.

[image expected here]

Move to Top or Bottom​

Move rows to the top or bottom of the list using the [x] and [x] buttons at the right end of the row, or by right-clicking the row to display the context menu. If multiple rows are selected, the action applies to the whole selection.

[image expected here]

[image expected here]

Remove Items​

Select one or more rows and click the [x] icon, or right-click a row and select Remove selected from the context menu, to remove the machines from the restore job.

Selecting the Destination​

In the Destination step, select the target Proxmox VE Node name and Target storage. To restore to the original location, choose the same node and storage the virtual machines were originally on; to restore to an alternate location, choose a different node, storage, or both. Both fields are required.

[image expected here]

Selecting Options​

In the Options step, set the following toggles, then click Next.

  • Autogenerate job name – enabled by default. When enabled, DPX generates the job name automatically, following the pattern proxmoxrestore-<date>_<time>, e.g. proxmoxrestore-2026-07-01_10-03-09. Disable to enter a custom job name.
  • Power on virtual machines after restoring – disabled by default. When enabled, each virtual machine is powered on once its own restore completes.
  • Delete restore job upon completion – enabled by default. When enabled and every virtual machine in the job restores successfully, DPX deletes the job definition once the job finishes.

[image expected here]

Reviewing the Summary and Saving​

The Summary step lists the source virtual machines with their Proxmox node and recovery point, together with the destination and options chosen in the previous steps. Review the definition and click Save.

[image expected here]

The Run Job dialog then asks whether to run the job immediately.

[image expected here]

Click Yes to start the restore now, or No to run it later from the Job Manager.

Running the Job​

A Proxmox VE restore job can be started from the Run Job dialog shown after saving, or from the Job Manager at any later time. Virtual machines are restored sequentially, in the order set in the Objects to Restore step; a failure on one virtual machine does not stop the restore of the others.

Restored virtual machines are always created as new machines on the destination node rather than overwriting an existing one – DPX reserves a new VM ID automatically and appends a -restored-<UTC date>-<UTC time> suffix to the original name, e.g. pve-ubuntu-01-restored-20260701-100309.

Note.

When a job restores several virtual machines and some of them fail while others succeed, the job finishes with a partial success status. The machines that completed are still available on the destination node; only the ones that failed need to be addressed and restored again.

Progress for each virtual machine is tracked individually and can be followed in the Job Monitor, the same way as for other restore job types. Cancelling a running job stops the transfer of the virtual machine currently in progress, removes its partially restored data from the destination node, and marks the remaining, not-yet-started virtual machines as cancelled.