Your Guide to How To Install Proxmox In Raspberry Pi
What You Get:
Free Guide
Free, helpful information about Computers & Operating Systems and related How To Install Proxmox In Raspberry Pi topics.
Helpful Information
Get clear and easy-to-understand details about How To Install Proxmox In Raspberry Pi topics and resources.
Personalized Offers
Answer a few optional questions to receive offers or information related to Computers & Operating Systems. The survey is optional and not required to access your free guide.
How to Install Proxmox on a Raspberry Pi
Proxmox Virtual Environment is a powerful, open-source hypervisor platform that lets you run virtual machines and containers from a single interface. It's built on Debian Linux and uses KVM (Kernel-based Virtual Machine) for full virtualization and LXC (Linux Containers) for lightweight containerization. For homelab enthusiasts, the idea of running Proxmox on a Raspberry Pi is genuinely appealing — but the path to making it work is more nuanced than a standard x86 installation.
Can You Actually Run Proxmox on a Raspberry Pi?
This is where you need a clear-eyed answer: Proxmox VE does not officially support ARM-based hardware, and the Raspberry Pi runs on an ARM processor (specifically ARMv8 / ARM Cortex-A series, depending on the model). The official Proxmox installers are compiled for x86_64 architecture only.
That said, the community has developed working methods to get Proxmox — or a close equivalent of its core functionality — running on a Raspberry Pi. The most widely used approach involves installing Proxmox's components manually on top of a Debian ARM64 base, essentially replicating what Proxmox does on x86 hardware using compatible ARM64 packages.
This is not a one-click install. It requires comfort with the Linux command line, package management, and some troubleshooting patience.
What You'll Need Before You Start
| Requirement | Details |
|---|---|
| Raspberry Pi model | Pi 4 or Pi 5 strongly recommended (4GB or 8GB RAM) |
| Storage | A fast microSD card or, better, a USB SSD for stability |
| Base OS | Debian 12 (Bookworm) ARM64 — not Raspberry Pi OS |
| Network | Wired Ethernet recommended during setup |
| Technical skill | Comfortable with terminal, SSH, and package management |
The Raspberry Pi 3 can technically work but its 1GB RAM ceiling makes running multiple VMs or containers impractical. The Pi 4 and Pi 5 with 4GB or 8GB RAM are the realistic minimum for a useful homelab setup.
Step-by-Step: Installing Proxmox on Raspberry Pi (ARM64 Method)
1. Flash Debian ARM64 to Your Storage Device
Download the official Debian 12 ARM64 image (not Raspberry Pi OS). Use a tool like Raspberry Pi Imager or balenaEtcher to write it to your microSD or USB drive. Raspberry Pi OS is based on a 32-bit or hybrid environment that complicates the process — pure Debian ARM64 is the cleaner foundation.
2. Boot and Configure Debian
Boot your Pi into Debian, set a static IP address, and enable SSH. A static IP is important because Proxmox ties its web interface to a specific network address. Edit /etc/network/interfaces or use nmcli depending on your network manager setup.
Update your system first: