Documentation
Architecture
Thunderbolt Debug

Thunderbolt Debug

Allo !!

QEMU Guest Agent

Running the QEMU Guest Agent inside your Debian 13 VM on Proxmox 9 is strongly recommended

Install it inside the VM:

systemctl enable --now qemu-guest-agent``

Then, enable it in the VM’s settings in the Proxmox web UI (Options → QEMU Guest Agent → Yes).


This allows Proxmox to:


    

  • Gracefully shut down or reboot the VM.
    • 

  • Display IP addresses.
    • 

  • Freeze filesystems for snapshots.
    • 

  • Improve backup consistency.
    • 




  
      

          Environment
          Needs QEMU Guest Agent
          Why
      

  
  
      

          Proxmox Host
          No
          It’s the hypervisor itself
      

      

          VM (KVM)
          Yes
          Enables clean shutdown, IP reporting, backups
      

      

          LXC Container
          No
          Uses Proxmox’s native container controls
      

  



Proxmox control LXC Containers natively with pct enter, pct exec
, etc.


When installed in a VM, it lets Proxmox talk to the guest OS directly. That enables:
•	Safe shutdowns & reboots from the Proxmox UI (qm shutdown works cleanly instead of forcing ACPI power-off).
•	Freeze/thaw for live backups (Proxmox can quiesce the filesystem so backups are consistent).
•	Accurate IP reporting (Proxmox dashboard shows the VM’s internal IP addresses).
•	Better integration (time sync, guest status, etc.).


It doesn’t add much overhead and is considered best practice for production or homelab VMs.





sudo apt update
sudo apt install qemu-guest-agent -y
sudo systemctl enable qemu-guest-agent
sudo systemctl start qemu-guest-agent
systemctl status qemu-guest-agent</code></pre></div><div class="hextra-code-copy-btn-container hx:opacity-0 hx:transition hx:group-hover/code:opacity-100 hx:flex hx:gap-1 hx:absolute hx:m-[11px] hx:right-0 hx:top-0">
  <button
    class="hextra-code-copy-btn hx:group/copybtn hx:cursor-pointer hx:transition-all hx:active:opacity-50 hx:bg-primary-700/5 hx:border hx:border-black/5 hx:text-gray-600 hx:hover:text-gray-900 hx:rounded-md hx:p-1.5 hx:dark:bg-primary-300/10 hx:dark:border-white/10 hx:dark:text-gray-400 hx:dark:hover:text-gray-50"
    title="Copy code"
  >
    <div class="hextra-copy-icon hx:group-[.copied]/copybtn:hidden hx:pointer-events-none hx:h-4 hx:w-4"></div>
<div class="hextra-success-icon hx:hidden hx:group-[.copied]/copybtn:block hx:pointer-events-none hx:h-4 hx:w-4"></div>
  </button>
</div>
</div>
<p>On the Proxmox side, go to your VM’s Options → QEMU Guest Agent and set it to Enabled.</p>

  






Disable IPv6 on ??


vi /etc/sysctl.d/99-disable-ipv6.conf




net.ipv6.conf.all.disable_ipv6 = 1
net.ipv6.conf.default.disable_ipv6 = 1
net.ipv6.conf.lo.disable_ipv6 = 1

  





sysctl --system


Disable IPv6 on Debian LXC Container


vi /etc/sysctl.d/disable-ipv6.conf




net.ipv6.conf.all.disable_ipv6 = 1
net.ipv6.conf.default.disable_ipv6 = 1
net.ipv6.conf.lo.disable_ipv6 = 1

  





sysctl --system



https://gist.github.com/scyto/67fdc9a517faefa68f730f82d7fa3570


Install LLDP
apt install lldpd


root@promox:~# cat /etc/modules


/etc/modules: kernel modules to load at boot time.
This file contains the names of kernel modules that should be loaded
at boot time, one per line. Lines beginning with “#” are ignored.
Parameters can be specified after the module name.
thunderbolt
thunderbolt-net


vi /etc/network/interfaces.d/thunderbolt


ERNEL[2123.755153] add      /devices/pci0000:00/0000:00:0d.2/domain0/0-0/usb4_port1/0-0:1.1 (thunderbolt)
UDEV  [2123.758030] add      /devices/pci0000:00/0000:00:0d.2/domain0/0-0/usb4_port1/0-0:1.1 (thunderbolt)
KERNEL[2123.765918] add      /devices/pci0000:00/0000:00:0d.2/domain0/0-0/usb4_port1/0-0:1.1/nvm_active0 (nvmem)
KERNEL[2123.765929] add      /devices/pci0000:00/0000:00:0d.2/domain0/0-0/usb4_port1/0-0:1.1/nvm_non_active0 (nvmem)
UDEV  [2123.766274] add      /devices/pci0000:00/0000:00:0d.2/domain0/0-0/usb4_port1/0-0:1.1/nvm_active0 (nvmem)
UDEV  [2123.766568] add      /devices/pci0000:00/0000:00:0d.2/domain0/0-0/usb4_port1/0-0:1.1/nvm_non_active0 (nvmem)
KERNEL[2124.333837] add      /devices/pci0000:00/0000:00:0d.2/domain0/0-0/0-1 (thunderbolt)
UDEV  [2124.334125] add      /devices/pci0000:00/0000:00:0d.2/domain0/0-0/0-1 (thunderbolt)
KERNEL[2124.335163] add      /devices/pci0000:00/0000:00:0d.2/domain0/0-0/0-1/nvm_active1 (nvmem)
KERNEL[2124.335170] add      /devices/pci0000:00/0000:00:0d.2/domain0/0-0/0-1/nvm_non_active1 (nvmem)
KERNEL[2124.335176] change   /devices/pci0000:00/0000:00:0d.2/domain0/0-0/0-1 (thunderbolt)
KERNEL[2124.335190] add      /devices/pci0000:00/0000:00:0d.2/domain0/0-0/0-1/wakeup/wakeup51 (wakeup)
UDEV  [2124.335468] add      /devices/pci0000:00/0000:00:0d.2/domain0/0-0/0-1/nvm_active1 (nvmem)
UDEV  [2124.335492] add      /devices/pci0000:00/0000:00:0d.2/domain0/0-0/0-1/nvm_non_active1 (nvmem)
UDEV  [2124.335623] change   /devices/pci0000:00/0000:00:0d.2/domain0/0-0/0-1 (thunderbolt)
UDEV  [2124.335692] add      /devices/pci0000:00/0000:00:0d.2/domain0/0-0/0-1/wakeup/wakeup51 (wakeup)
KERNEL[2124.340510] change   /devices/pci0000:00/0000:00:0d.2/domain0/0-0/0-1 (thunderbolt)
UDEV  [2124.340728] change   /devices/pci0000:00/0000:00:0d.2/domain0/0-0/0-1 (thunderbolt)
CMDBWeb Sites