GitPedia

Pimox7

Proxmox V7 for Raspberry Pi

From pimox·Updated June 12, 2026·View on GitHub·

Pimox is a port of Proxmox to the Raspberry Pi allowing you to build a Proxmox cluster of Rapberry Pi's or even a hybrid cluster of Pis and x86 hardware. The project is written primarily in Shell, first published in 2021. It has gained significant community traction with 1,992 stars and 175 forks on GitHub. Key topics include: proxmox, raspberry-pi.

Pimox - Proxmox V7 for the Raspberry Pi

Pimox is a port of Proxmox to the Raspberry Pi allowing you to build a Proxmox cluster of Rapberry Pi's or even a hybrid cluster of Pis and x86 hardware.

Requirements

  • Raspberry Pi 4
  • Internet connection via ethernet

Install from "scratch", RPiOS64bit Interactive Automatic Installer

  1. Flash and startup the latest image from https://downloads.raspberrypi.org/raspios_arm64/ .
  2. sudo -s
  3. curl https://raw.githubusercontent.com/pimox/pimox7/master/RPiOS64-IA-Install.sh > RPiOS64-IA-Install.sh
  4. chmod +x RPiOS64-IA-Install.sh
  5. ./RPiOS64-IA-Install.sh
  6. Follow the prompts

Manual installation

Prechecks

  1. Pre-installed Debian Bullseye based 64-bit OS (not 32bit)
  2. In /etc/network/interfaces, give the Pi a static IP address. You cannot use dhcp.
  3. In /etc/network/interfaces, remove any IPv6 addresses.
  4. In /etc/hostname, make sure the Pi has a name.
  5. In /etc/hosts, make sure this hostname corresponds to the static IP you previous set.
  6. Make sure the kernel-headers are installed.

Installation

  1. echo "deb https://raw.githubusercontent.com/pimox/pimox7/master/ dev/" > /etc/apt/sources.list.d/pimox.list
  2. curl https://raw.githubusercontent.com/pimox/pimox7/master/KEY.gpg | apt-key add -
  3. apt update
  4. apt install proxmox-ve (use a local attatched console! Network connections will be lost/reset during installation progress)

Notes

  1. This repo just contains the precompiled debian packages. The original Proxmox sources can be found at https://git.proxmox.com
  2. The (very minimally) patched sources to rebuild this can be found at https://github.com/pimox

Contributors

Showing top 6 contributors by commit count.

View all contributors on GitHub →

This article is auto-generated from pimox/pimox7 via the GitHub API.Last fetched: 6/14/2026