Skip to content

Instantly share code, notes, and snippets.

@the-polak
Forked from enjikaka/instructions.md
Last active September 1, 2025 16:16
Show Gist options
  • Select an option

  • Save the-polak/20a3156b24b2f5c966bd898ff1a8cfdc to your computer and use it in GitHub Desktop.

Select an option

Save the-polak/20a3156b24b2f5c966bd898ff1a8cfdc to your computer and use it in GitHub Desktop.
Installing Proxmox on Raspberry Pi 5 - pimox
title pimox howto
date 2024-10-31 00:55:00 +0500
categories
proxmox
pimox
raspberry pi 5
tags
rpi5
howto
pve

Deprecated. Instructions may not be accurate. Seek other guides

Installing Proxmox 8.x on Raspberry Pi 5

Many thanks to the OP of this guide @enjikaka. I've decided to fork and submit a few updates. Progression through unlearning. Numerous guides exist but none were as comprehensive and direct. Minor updates to the apt repo and apt sources in Step 8 and a few cosmetic things.

1 - Flashing the OS

Install "RPi OS Lite 64-bit" with Raspberry Pi Imager. It's listed under "Raspberry Pi OS (Other)"

2 - Network config

Assign your Pi a static IP in your router, then SSH into the Pi and launch the network config GUI with nmtui and adjust to the static ip.

3 - Install updates

apt-get update
apt-get upgrade

Alternatively, update rpiOS via raspi-config

sudo raspi-config

4 - Assign a password to the root user

The default user in Proxmox is root. From this point forward I will continue the installation as root. Run sudo -i to get a root prompt, then passwd to set your root password. This will be the login for the Proxmox UI.

Alternatively:

kielbasa@pimox5:~ $ sudo passwd root
New password:
Retype new password:
passwd: password updated successfully
kielbasa@pimox5:~ $ su root
Password:
root@pimox5:/home/kielbasa#

5 - Edit your host file

Backup and modify hosts

cp /etc/hosts /etc/hosts.bak
nano /etc/hosts
127.0.0.1 localhost pimox5
192.168.1.xx pimox5
::1 localhost ip6-localhost ip6-loopback
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters

Important

Replace 192.168.1.xx with your static IP.

6 - Edit your hostname

nano /etc/hostname
pimox5
# rpi5            <------------ Be sure to delete or comment this line!

7 - Reboot

reboot

8 - Add sources and keys

echo "deb [arch=arm64] https://global.mirrors.apqa.cn/proxmox/debian/pve bookworm port">/etc/apt/sources.list.d/pveport.list

echo 'deb [arch=arm64] https://mirrors.apqa.cn/proxmox/debian/pve bookworm port' | sudo tee /etc/apt/sources.list.d/pveport.list

curl https://global.mirrors.apqa.cn/proxmox/debian/pveport.gpg -o /etc/apt/trusted.gpg.d/pveport.gpg

curl -L https://mirrors.apqa.cn/proxmox/debian/pveport.gpg | sudo tee /etc/apt/trusted.gpg.d/pveport.gpg >/dev/null

9 - Update and install Proxmox

apt-get update
apt-get upgrade
apt-get full-upgrade
apt-get dist-upgrade
apt-get install ifupdown2
apt-get install proxmox-ve postfix open-iscsi chrony mmc-utils usbutils

10 - Edit your network interface

  • Backup and modify /etc/network/interfaces
cp /etc/network/interfaces /etc/network/interfaces.bak
nano /etc/network/interfaces
# interfaces(5) file used by ifup(8) and ifdown(8)
# Include files from /etc/network/interfaces.d:
# source /etc/network/interfaces.d/*                <------------ Be sure to comment this line out!



auto lo
iface lo inet loopback

iface eth0 inet manual

auto vmbr0
iface vmbr0 inet static
address 192.168.1.xx/24
gateway 192.168.1.1
bridge-ports eth0
bridge-stp off
bridge-fd 0

iface eth0 inet manual

Important

Replace 192.168.1.xx with your static IP.

11 - Add DNS server

For me /etc/resolv.conf was empty. I added nameserver 1.1.1.1 to this file.

12 - Reboot

Reboot your Pi again with reboot.

13 - Proxmox Installation Complete

You can now reach your Proxmox UI on http://pimox5.local:8006 or http://192.168.1.xx:8006 and login with the username root and the password you set in 11.

Important

Replace 192.168.1.xx with your static IP.

Post Install

Pimox Helper Scripts https://github.com/asylumexp/Proxmox

LXC Images

https://stevetech.me/posts/find-arm64-lxc-templates


Sources

Mastodon Bluesky

@nicojaraiz

Copy link
Copy Markdown

All the steps work correctly for me, but when I try to use the post-installation script I get that I do not have version 8.0 or later, but I am on the 8.3 interface

@the-polak

Copy link
Copy Markdown
Author

I've amended the instructions. After I wrote the document the Proxmox Helper Scripts project changed hands. I haven't had time to test and troubleshoot. In the meantime check out:

pimox-scripts.com

I appreciate you notifying me. After the holidays i'll have a bit more time to devote to updating the documentation.

@Pippers

Pippers commented Aug 31, 2025

Copy link
Copy Markdown

This doesn't appear to work. Where you add the keys and dist for apt:

"The key(s) in the keyring /etc/apt/trusted.gpg.d/pveport.gpg are ignored as the file has an unsupported filetype."
"E: The repository 'https://mirrors.apqa.cn/proxmox/debian/pve bookworm Release' does not have a Release file."
"N: Updating from such a repository can't be done securely, and is therefore disabled by default."

@the-polak

the-polak commented Sep 1, 2025

Copy link
Copy Markdown
Author

I've abandoned proxmox on the pi 5. Apologies for not updating the instructions to indiciate they are deprecated. Check this guide out for further instruction:
https://pimylifeup.com/raspberry-pi-proxmox/

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment