Installing Proxmox on Raspberry Pi 4 and 5 (Pimox)

instructions.md

Installing Proxmox on Raspberry Pi 4 and 5

With these steps I managed to get Pimox on my Raspberry Pi 4 and 5 in february 2024.

Step 1 - Flashing the OS

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

I set my user and password already here in the Raspberry Pi Imager when asked for config, so it's easy to SSH in later. I suggest you do the same.

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

Step 3 - Install updates

apt-get update
apt-get upgrade

Step 4 - Edit your host file

nano /etc/hosts

127.0.0.1 localhost pimox5
192.168.0.xx pimox5
::1 localhost ip6-localhost ip6-loopback
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters

Important

Replace 192.168.0.xx with the static IP you assigned your Pi in your router.

Step 5 - Edit your hostname

nano /etc/hostname

pimox5

Step 6 - Reboot

reboot

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

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

Step 8 - 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

Step 9 - Edit your network interface

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/*

auto lo
iface lo inet loopback

iface eth0 inet manual

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

iface eth0 inet manual

Important

Replace 192.168.0.xx with the static IP you assigned your Pi in your router.

Step 10 - Add DNS server

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

Step 11 - Reboot

Reboot your Pi again with reboot.

Step 12 - Assign a password to your root user

Run sudo -i to get a root prompt, then passwd to set your password. This will be the login for the Proxmox UI.

Step 13 - Done

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

Important

Replace 192.168.0.xx with the static IP you assigned your Pi in your router.

Sources

• https://forum.proxmox.com/threads/proxmox-on-aarch64-arm64.121925/page-3
• https://www.reddit.com/r/Proxmox/comments/vpgn3f/how_to_login_pve_without_root_on_debian_after/

Now what?

If you want Home Assistant on your Pimox instance you can use the PiMox HAOS VM script from here to set up a VM with Home Assistant OS: https://tteck.github.io/Proxmox/

Faced issue at step7
instead use
echo "deb [arch=arm64] https://global.mirrors.apqa.cn/proxmox/debian/pve bookworm port" | sudo tee /etc/apt/sources.list.d/pveport.list

Step 4 contains the hostname twice, it shall be removed from line #1:

127.0.0.1 localhost
192.168.0.xx pimox5

echo "deb [arch=arm64] https://global.mirrors.apqa.cn/proxmox/debian/pve bookworm port">/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

Replace https with http in links if certificate error occurs.

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

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

@eduwx thanks for the fix. Even better alternative to ensure we point to a trustworthy repo I did following (retained as https and removed global) it was ok to have more latency than compromise on security.

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

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

Anyone knows who's behind this repository ?
If there is a page somewhere with information on the maintainer or even just their email ?
I'm trying to assess

• how much trust we can place in it
• how long term this port is

edit: self-answering partially

• this guy https://github.com/jiangcuo
• they refer to this website https://foxi.buduanwang.vip/ (seems to be a blog of some kind revolving around Proxmox - tutorials, best practices).

Quite interestingly, he apparently documents how to install PVE on smartphones (MediaTek Dimensity 1200)

If you've got lots of boards, I just wrote an Ansible playbook to configure everything in one shot, without reboots.

https://github.com/AnnoyingTechnology/raspberry-proxmox-ansible-deploy

Faced issue at step7 instead use echo "deb [arch=arm64] https://global.mirrors.apqa.cn/proxmox/debian/pve bookworm port" | sudo tee /etc/apt/sources.list.d/pveport.list

Me too.

This is still the best guide I've found, though. Correct repo/source can be found here

Add the server URL to a new configuration under /etc/apt:

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

Add the server key to your trusted sources:

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

Run an update to add this source for the next installations:

sudo apt update

After finishing the steps, i cant connect to the pi with SSH nor the IP+port... anyone have the same issure?

After finishing the steps, i cant connect to the pi with SSH nor the IP+port... anyone have the same issure?

Can you reach the PVE web gui?

After finishing the steps, i cant connect to the pi with SSH nor the IP+port... anyone have the same issure?

Can you reach the PVE web gui?

Nope, nothing. Its the third time I’ve installed proxmox with this guide.

After finishing the steps, i cant connect to the pi with SSH nor the IP+port... anyone have the same issure?

Can you reach the PVE web gui?

Nope, nothing. Its the third time I’ve installed proxmox with this guide.

I fat fingered my /etc/hosts and /etc/network/interfaces a few times.

I eventually got this guide to work but modified it a bit and published my revisions with additional context.
https://github.com/the-polak/pimox