DanpLab · Lab NoteArchitettura operativa

Proxmox VE Homelab: Complete Guide from Start to Finish

Build your professional homelab with Proxmox VE: installation, storage, VLAN networking, automatic backups, LXC containers and GPU passthrough for AI workloads.

1 min readBased on real operational use
proxmoxhomelabvirtualizationdocker

Why Proxmox VE

Proxmox Virtual Environment is a Debian-based open-source hypervisor combining KVM (full VMs) and LXC (lightweight containers). It's ideal for a homelab because:

  • Free (with community repository)
  • Professional Web UI — manage everything from the browser
  • KVM + LXC — full VMs and containers on the same platform
  • Native clustering — add nodes without reinstalling
  • Full REST API — automation with Ansible and Terraform

Post-installation: Community Repository


rm /etc/apt/sources.list.d/pve-enterprise.list


echo "deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription" \
  > /etc/apt/sources.list.d/pve-community.list

apt update && apt full-upgrade -y

Creating an LXC Container


pveam update
pveam download local debian-12-standard_12.7-1_amd64.tar.zst


pct create 100 local:vztmpl/debian-12-standard_12.7-1_amd64.tar.zst \
  --hostname web-server \
  --cores 2 \
  --memory 2048 \
  --rootfs local-lvm:20 \
  --net0 name=eth0,bridge=vmbr0,ip=192.168.1.100/24,gw=192.168.1.1 \
  --unprivileged 1 \
  --start 1

GPU Passthrough for AI



nano /etc/default/grub
update-grub


echo "vfio" >> /etc/modules
echo "vfio_iommu_type1" >> /etc/modules
update-initramfs -u -k all


echo "blacklist nouveau" >> /etc/modprobe.d/blacklist.conf
echo "blacklist nvidia" >> /etc/modprobe.d/blacklist.conf

Then add the GPU via Proxmox UI: Hardware → Add → PCI Device


Automated Backups


vzdump job
    enabled: 1
    schedule: sun 2:00
    storage: backup-nas
    mode: snapshot
    compress: zstd
    mailto: [email protected]
    vmid: 100,101,102,200
    maxfiles: 3

Resources