Quick Start: Get Proxmox Running in 5 Minutes
VMware just killed your free ESXi license. Your home lab is down. It’s Saturday night. Sound familiar? I’ve been there — and that’s exactly how I discovered Proxmox VE. Three years later, I’m running it on production infrastructure and haven’t looked back once.
Proxmox VE (Virtual Environment) is a Debian-based hypervisor that bundles KVM virtualization and LXC containers into a single web UI. Completely free, open-source, and no license key required for core features.
Here’s the fastest path to a running VM:
- Download the ISO from proxmox.com/en/downloads
- Flash it to a USB drive with Balena Etcher or
dd - Boot your target machine, run the installer (takes ~5 minutes)
- Access the web UI at
https://<your-ip>:8006
That’s it. You’re in. No license server, no trial expiry, no phone-home activation.
Deep Dive: What Proxmox VE Actually Is
Proxmox isn’t just a GUI slapped on top of KVM. It’s a full stack:
- KVM — full hardware virtualization for Windows, Linux, BSD VMs
- LXC — lightweight Linux containers (think Docker, but at the OS level)
- Proxmox Cluster (pvecm) — multi-node high availability without enterprise licensing
- Ceph integration — distributed storage baked right in
- ZFS support — native snapshots, compression, self-healing filesystem
Installing Proxmox VE
The installer is straightforward, but a few choices matter long-term. When prompted for disk layout, pick ZFS if your hardware supports it. You’ll thank yourself later when snapshots save your work at 2 AM.
# After installation, update the package repo to avoid subscription nags
# Edit /etc/apt/sources.list.d/pve-enterprise.list and comment out the line:
# deb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise
# Add the free community repo instead
echo "deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription" \
> /etc/apt/sources.list.d/pve-no-subscription.list
apt update && apt dist-upgrade -y
You’ll also get a subscription nag on every login. A one-liner patch kills it — search “Proxmox no-subscription nag” and you’ll find community scripts for every version.
Creating Your First VM
Upload an ISO to local storage first:
# Via CLI (faster for large ISOs)
wget -O /var/lib/vz/template/iso/ubuntu-24.04.iso \
https://releases.ubuntu.com/24.04/ubuntu-24.04-live-server-amd64.iso
Then from the web UI: Create VM → select ISO → assign CPU/RAM/disk → Start. The VNC console opens right in the browser — no separate client needed.
LXC Containers: The Hidden Superpower
Most people treat Proxmox like VMware and only use full VMs. That’s leaving half the value on the table. LXC containers boot in under a second and barely touch your RAM. A Pi-hole LXC idles at around 30MB. A full VM doing the same job needs 512MB minimum.
# Download a container template
pveam update
pveam available --section system | grep debian
pveam download local debian-12-standard_12.2-1_amd64.tar.zst
# Create an LXC container via CLI
pct create 200 local:vztmpl/debian-12-standard_12.2-1_amd64.tar.zst \
--hostname pihole \
--memory 512 \
--cores 1 \
--net0 name=eth0,bridge=vmbr0,ip=dhcp \
--rootfs local-lvm:8 \
--start 1
That container is now running. SSH in, install whatever you need. The overhead is negligible — I run 12 LXC containers on a machine with 16GB RAM and still have headroom to spare.
Advanced Usage: Features VMware Charges For
Snapshots and Backups
With ZFS storage, snapshots are instant and space-efficient. Snapshot before a risky change, roll back in seconds if something breaks:
# Snapshot a running VM (VM ID 100)
qm snapshot 100 pre-upgrade --description "Before kernel upgrade" --vmstate
# List snapshots
qm listsnapshot 100
# Rollback
qm rollback 100 pre-upgrade
For scheduled backups, Proxmox has built-in backup jobs under Datacenter → Backup. Set it to run nightly to local storage or a remote NFS/CIFS share. I run weekly fulls plus daily snapshots in production — a drive died on a Wednesday and everything was back up before the morning standup.
Clustering Without Enterprise License
VMware’s HA clustering requires vCenter and expensive licenses. Proxmox clustering is free. It works with as few as two nodes, though three is recommended for quorum:
# On the first node, create the cluster
pvecm create my-homelab-cluster
# On additional nodes, join the cluster
pvecm add 192.168.1.10 # IP of the first node
# Check cluster status
pvecm status
Once clustered, live-migrate running VMs between nodes with a single click. Using local storage? No problem — Proxmox handles the transfer automatically, no shared storage required.
Networking: VLANs and Bridges
Under the hood, networking runs through standard Linux bridges and VLANs. To tag traffic for different network segments:
# Edit /etc/network/interfaces to add a VLAN-aware bridge
auto vmbr0
iface vmbr0 inet static
address 192.168.1.10/24
gateway 192.168.1.1
bridge-ports eno1
bridge-stp off
bridge-fd 0
bridge-vlan-aware yes
bridge-vids 2-4094
After that, assign VLANs directly to VM network interfaces in the UI. Useful for isolating a homelab DMZ from your trusted network.
GPU Passthrough
Want to pass a physical GPU directly to a Windows VM for gaming or AI workloads? Proxmox supports PCIe passthrough cleanly:
# Enable IOMMU in GRUB (/etc/default/grub)
GRUB_CMDLINE_LINUX_DEFAULT="quiet intel_iommu=on iommu=pt"
# (use amd_iommu=on for AMD CPUs)
update-grub
# Add vfio modules to /etc/modules
echo -e "vfio\nvfio_iommu_type1\nvfio_pci\nvfio_virqfd" >> /etc/modules
update-initramfs -u -k all
reboot
Then add a PCI device in the VM’s hardware settings and select your GPU. The VM gets bare-metal GPU performance — benchmarks within 1-2% of native.
Practical Tips From Real-World Use
Resource Sizing
Don’t over-allocate. Proxmox (like VMware) supports memory ballooning — VMs only use physical RAM when they actually need it. Assign more vCPUs and RAM than your physical resources. The hypervisor handles contention gracefully.
Use Tags to Stay Organized
Once you hit 20+ VMs and containers, the UI turns into a wall of names. Tag everything — production, testing, homelab, dns, monitoring. Filter the VM list by tag and you’ll spot what’s what in seconds.
API Access for Automation
Proxmox has a full REST API. Create an API token under Datacenter → Permissions → API Tokens and automate everything with Terraform, Ansible, or Python:
# Quick API test — list nodes
curl -s -k -H "Authorization: PVEAPIToken=root@pam!mytoken=your-token-uuid" \
https://192.168.1.10:8006/api2/json/nodes | python3 -m json.tool
The Subscription Question
Paid subscriptions start at €110/year per node. You get access to the enterprise repo and official support. For homelab use, the free tier is more than enough. For production, the subscription is worth it — not because the software differs (it doesn’t), but because it funds a tool you’re now depending on.
When VMware pulled the free ESXi license, thousands of homelabbers and small businesses scrambled. Most landed on Proxmox and stayed. The learning curve from ESXi is maybe an afternoon. ESXi never gave you LXC containers, built-in ZFS, or free clustering — Proxmox does all three without a credit card. Grab a spare machine or an old workstation, and you’ll have a capable hypervisor running before lunch.

