Skip to content

Raspberry Pi OS

This page outlines the setup of Raspberry Pi OS for use with Proxmox on a Raspberry Pi 5.

⚙ Installation

Setup Raspberry Pi OS

Create a tmp dir

cd "$(mktemp -d)"

Get the latest image version

curl -fsSL https://downloads.raspberrypi.com/raspios_lite_arm64/images/ | grep -Eo '[a-zA-Z0-9_.-]+-[0-9]{4}-[0-9]{2}-[0-9]{2}' | sort -u | tail -n 1

Output

raspios_lite_arm64-2025-11-24

curl -fsSL https://downloads.raspberrypi.com/raspios_lite_armhf/images/ | grep -Eo '[a-zA-Z0-9_.-]+-[0-9]{4}-[0-9]{2}-[0-9]{2}' | sort -u | tail -n 1

Output

raspios_lite_armhf-2025-11-24

Download image

curl -fSLO https://downloads.raspberrypi.com/raspios_lite_arm64/images/raspios_lite_arm64-2025-11-24/2025-11-24-raspios-trixie-arm64-lite.img.xz

curl -fSLO https://downloads.raspberrypi.com/raspios_lite_armhf/images/raspios_lite_armhf-2025-11-24/2025-11-24-raspios-trixie-armhf-lite.img.xz

Note

Pay attention to which debian version the download URL is (e.g. trixie, bookworm, etc.)

See raspios_lite_arm64 and raspios_lite_armhf.

Write image to SD card

xzcat 2025-11-24-raspios-trixie-arm64-lite.img.xz | dd /dev/mmcblk0 status=progress

Mount boot partition

(
  [ -d /media/sd ] || mkdir /media/sd
  sudo mount -a /dev/mmcblk0p1 /media/sd
)

Change to boot partition

cd /media/sd

Create Username & Password

/boot/firmware/userconf.txt

echo 'nicholas:' "$(openssl passwd -6)" | sed 's/ //g' | sudo tee -a userconf.txt

nicholas:<hash>

💻 Enable SSH

/boot/ssh

touch ssh

📄 Kernel Page Size

You should use the Kernel with 4K pagesize

/boot/firmware/config.txt

kernel=kernel8.img # to end of line

CT Notes

Is the container summary memory usage and swap usage always shows 0?

/boot/firmware/cmdline.txt

sed -i '1s/$/ cgroup_enable=cpuset cgroup_enable=memory cgroup_memory=1/' cmdline.txt

cgroup_enable=cpuset cgroup_enable=memory cgroup_memory=1

Unmount SD card, plug into the Raspberry Pi and boot

PXVIRT Installation

Tip

Alternatively, the ISO may be downloaded and installed as a removable media.

Log into the Raspberry Pi using SSH.

Switch to root user. Default password is blank for Raspberry Pi OS."

sudo su root

Set root password so that you can log into Proxmox web GUI

passwd

Add an /etc/hosts entry for your IP address.

Please make sure that your machine's hostname is resolvable via /etc/hosts, i.e. you need an entry in /etc/hosts which assigns an address to its hostname.

Make sure that you have configured one of the following addresses in /etc/hosts for your hostname:

1 IPv4 or 1 IPv6 or 1 IPv4 and 1 IPv6

Note

This also means removing the address 127.0.1.1 that might be present as default.

Get IP address

hostname -I | awk '{print $1}'

For instance, if your IP address is 192.168.15.77, and your hostname prox4m1, then your /etc/hosts file could look like:

/etc/hosts

127.0.0.1       localhost.localdomain localhost

::1             localhost ip6-localhost ip6-loopback
ff02::1         ip6-allnodes
ff02::2         ip6-allrouters

192.168.1.192   pve02.nicholaswilde.io pve02

Test if your setup is ok using the hostname command

hostname --ip-address

should return your IP address here

192.168.1.192

Then see install PXVIRT.

🔗 References