Skip to content

Instantly share code, notes, and snippets.

@the-polak
Forked from enjikaka/instructions.md
Last active November 2, 2024 19:59
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

Glorious Proxmox Helper Script

Post Install Script

image

# Run as root
bash -c "$(wget -qLO - https://github.com/tteck/Proxmox/raw/main/misc/post-pve-install.sh)"

LXC Images

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


Sources

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