<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Mike Maiolo | Pontavia Consulting</title>
    <description>The latest articles on DEV Community by Mike Maiolo | Pontavia Consulting (@admin_pontaviaconsulting).</description>
    <link>https://dev.to/admin_pontaviaconsulting</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4254427%2F574d86d1-0526-4d55-b6f8-6d2995c57b28.png</url>
      <title>DEV Community: Mike Maiolo | Pontavia Consulting</title>
      <link>https://dev.to/admin_pontaviaconsulting</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/admin_pontaviaconsulting"/>
    <language>en</language>
    <item>
      <title>How to Test That Proxmox Backups Actually Restore</title>
      <dc:creator>Mike Maiolo | Pontavia Consulting</dc:creator>
      <pubDate>Thu, 19 Nov 2026 19:47:35 +0000</pubDate>
      <link>https://dev.to/admin_pontaviaconsulting/how-to-test-that-proxmox-backups-actually-restore-3863</link>
      <guid>https://dev.to/admin_pontaviaconsulting/how-to-test-that-proxmox-backups-actually-restore-3863</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Key takeaways&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;A successful backup job only proves an archive was written, not that the guest inside it will boot.&lt;/li&gt;
&lt;li&gt;Restore to a spare VM ID with &lt;code&gt;--unique 1&lt;/code&gt; and unplug the network (&lt;code&gt;link_down=1&lt;/code&gt;) before the first boot.&lt;/li&gt;
&lt;li&gt;Wait a few minutes and check again: a guest that boots and then crashes is still a failed restore.&lt;/li&gt;
&lt;li&gt;Destroy the test copy afterwards. Automate the routine, or it stops after the first time.&lt;/li&gt;
&lt;/ul&gt;
&lt;/blockquote&gt;

&lt;h2&gt;
  
  
  Why a green backup job is not proof
&lt;/h2&gt;

&lt;p&gt;A backup job that finishes successfully tells you an archive was written. On Proxmox Backup Server, a verify job goes further and checks that the stored data is intact. Neither one tells you that the guest inside the archive will boot and stay up. The only way to know is to restore it somewhere safe and look. The &lt;a href="https://pve.proxmox.com/pve-docs/chapter-vzdump.html" rel="noopener noreferrer"&gt;Proxmox backup and restore documentation&lt;/a&gt; explains the restore commands used below.&lt;/p&gt;

&lt;h2&gt;
  
  
  What a restore test needs to prove
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;The backup restores completely, with enough disk space and time.&lt;/li&gt;
&lt;li&gt;The restored guest boots and keeps running for a few minutes.&lt;/li&gt;
&lt;li&gt;The test copy cannot reach your real network, so it cannot clash with the original (same IP address, same services, even outgoing email).&lt;/li&gt;
&lt;li&gt;The copy is deleted afterwards, so test restores never pile up.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Testing a virtual machine by hand
&lt;/h2&gt;

&lt;p&gt;&lt;strong&gt;1. Find a backup.&lt;/strong&gt; Replace &lt;code&gt;local&lt;/code&gt; with the storage that holds your backups.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;pvesm list &lt;span class="kd"&gt;local&lt;/span&gt; --content backup
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;2. Pick an unused VM ID&lt;/strong&gt; such as 9100. Never restore onto the original ID: that overwrites the real guest.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;3. Restore it as a new guest&lt;/strong&gt; with a new MAC address. This example restores from a local vzdump archive:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;qmrestore /var/lib/vz/dump/vzdump-qemu-100-2026_11_17-02_00_01.vma.zst 9100 --storage local-lvm --unique 1
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;From Proxmox Backup Server, point at the backup instead:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;qmrestore pbs:backup/vm/100/2026-11-17T02:00:01Z 9100 --storage local-lvm --unique 1
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;4. Unplug the network before the first boot.&lt;/strong&gt; Look at the network devices, then set each one with &lt;code&gt;link_down=1&lt;/code&gt;, which is the same as pulling the cable. Keep the model and bridge you see in the config.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;qm config 9100 &lt;span class="o"&gt;|&lt;/span&gt; grep ^net
qm &lt;span class="nb"&gt;set&lt;/span&gt; 9100 --net0 virtio,bridge=vmbr0,link_down=1
qm &lt;span class="nb"&gt;set&lt;/span&gt; 9100 --onboot 0
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;5. Start it and check it is alive.&lt;/strong&gt; The agent check only works if the QEMU guest agent is installed and enabled for that guest.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;qm start 9100
qm status 9100
qm guest cmd 9100 ping
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;6. Wait a few minutes and check again.&lt;/strong&gt; A guest that boots and then crashes is still a failed restore.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;7. Clean up.&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;qm stop 9100
qm destroy 9100 --purge
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Testing a container
&lt;/h2&gt;

&lt;p&gt;Containers work the same way with &lt;code&gt;pct&lt;/code&gt;. The &lt;code&gt;pct set&lt;/code&gt; command replaces the whole network device, so copy the name and bridge from the config first. See the &lt;a href="https://pve.proxmox.com/pve-docs/pct.1.html" rel="noopener noreferrer"&gt;&lt;code&gt;pct&lt;/code&gt; manual&lt;/a&gt; for every option.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;pct restore 9101 /var/lib/vz/dump/vzdump-lxc-105-2026_11_17-02_10_00.tar.zst --storage local-lvm --unique 1
pct config 9101 &lt;span class="o"&gt;|&lt;/span&gt; grep ^net0
pct &lt;span class="nb"&gt;set&lt;/span&gt; 9101 --net0 &lt;span class="nv"&gt;name&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;eth0,bridge=vmbr0,link_down=1
pct start 9101
pct &lt;span class="nb"&gt;exec&lt;/span&gt; 9101 -- systemctl is-system-running
&lt;span class="c"&gt;# ...wait a few minutes, check again, then:&lt;/span&gt;
pct stop 9101
pct destroy 9101 --purge
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h2&gt;
  
  
  Things that trip people up
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Disk space.&lt;/strong&gt; The restore needs room for the whole guest on the target storage.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Load.&lt;/strong&gt; A large restore slows the node. Run it at a quiet hour.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Hardware dependencies.&lt;/strong&gt; A guest that uses PCI passthrough or a USB device may not boot as a test copy. Test those configurations separately.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Encrypted backups.&lt;/strong&gt; You need the key to restore them, so keep it somewhere other than the node being backed up.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Test different guests.&lt;/strong&gt; Rotate through them so every important guest gets tested over time.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Doing it every night without remembering
&lt;/h2&gt;

&lt;p&gt;Done by hand this is a few minutes per guest, which is why it usually stops after the first time. Pontavia's &lt;a href="https://pontaviaconsulting.com/proxmox-tools.html" rel="noopener noreferrer"&gt;Backup Proof&lt;/a&gt; ($79) is an n8n workflow that runs the same idea nightly: it restores one backup to a throwaway copy with the network unplugged, checks it boots and stays up, then deletes it. You get a record of every restore that worked and an alert the night one does not, sent to Discord, Slack, ntfy or any webhook. It works for containers and VMs and runs in your own n8n.&lt;/p&gt;

&lt;p&gt;If you want a quick look at your whole cluster first, the &lt;a href="https://pontaviaconsulting.com/proxmox-tools.html" rel="noopener noreferrer"&gt;Proxmox Daily Health Report&lt;/a&gt; is free: offline nodes and storage, storage filling up, guests with no recent backup or in no backup job, old snapshots and failed backup jobs. It only reads.&lt;/p&gt;

&lt;h2&gt;
  
  
  Frequently asked questions
&lt;/h2&gt;

&lt;h3&gt;
  
  
  How often should I test Proxmox backup restores?
&lt;/h3&gt;

&lt;p&gt;Test your most important guests at least monthly, and any time you change backup storage, retention or job settings. Rotating through different guests is better than testing the same one every time.&lt;/p&gt;

&lt;h3&gt;
  
  
  Does a Proxmox Backup Server verify job replace a restore test?
&lt;/h3&gt;

&lt;p&gt;No. A verify job checks that the stored backup data is intact. It does not boot the guest, so it cannot tell you the guest will start or stay up.&lt;/p&gt;

&lt;h3&gt;
  
  
  Can I restore a backup next to the original guest?
&lt;/h3&gt;

&lt;p&gt;Yes, if you use a new VM ID with &lt;code&gt;--unique 1&lt;/code&gt; and set &lt;code&gt;link_down=1&lt;/code&gt; on the network devices before the first boot, so the copy cannot clash with the original.&lt;/p&gt;

&lt;h3&gt;
  
  
  Do I need the QEMU guest agent to test a restore?
&lt;/h3&gt;

&lt;p&gt;No. The agent only powers the &lt;code&gt;qm guest cmd &amp;lt;id&amp;gt; ping&lt;/code&gt; check. Without it, check the guest on the console and confirm it stays running.&lt;/p&gt;




&lt;p&gt;&lt;em&gt;Originally published at &lt;a href="https://pontaviaconsulting.com/proxmox-test-backup-restore.html" rel="noopener noreferrer"&gt;pontaviaconsulting.com&lt;/a&gt;. More guides like this: &lt;a href="https://pontaviaconsulting.com/guides.html" rel="noopener noreferrer"&gt;https://pontaviaconsulting.com/guides.html&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>proxmox</category>
      <category>homelab</category>
      <category>sysadmin</category>
      <category>backup</category>
    </item>
  </channel>
</rss>
