Skip to content

Instantly share code, notes, and snippets.

@the-polak
Forked from enjikaka/instructions.md
Last active January 1, 2025 04:45
Show Gist options
  • Save the-polak/20a3156b24b2f5c966bd898ff1a8cfdc to your computer and use it in GitHub Desktop.
Save the-polak/20a3156b24b2f5c966bd898ff1a8cfdc to your computer and use it in GitHub Desktop.
Installing Proxmox on Raspberry Pi 5 - pimox
title date categories tags
pimox howto
2024-10-31 00:55:00 +0500
proxmox
pimox
raspberry pi 5
rpi5
howto
pve

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

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
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.

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