Skip to main content

Neue Seite

Raspberry Pi 4 (8 GB) als Proxmox-Test-Node

Basis: Debian 13 (Trixie) ARM64, Raspberry-Pi-kompatibler Kernel und angepasste Proxmox/PXVIRT-Pakete. Einsatz: ausschließlich Homelab/Test.

Wichtig: Der Raspberry Pi 4 wird von Proxmox VE nicht offiziell unterstützt. Der offizielle ARM64-ISO-Installer und PVE-Kernel sind kein direkt nutzbarer Installationsweg auf dem Pi. Die hier verwendete Community-Lösung kann sich jederzeit ändern.

1. Voraussetzungen und Downloads

Hinweis: Das Debian-Image ist ein komprimiertes Datenträgerimage, keine ISO. Archiv entpacken und die enthaltene Datenträgerdatei auf die SSD schreiben. Dabei wird der ausgewählte Datenträger vollständig überschrieben.

2. Debian installieren

  1. Das Debian-ARM64-Image herunterladen, entpacken und mit dem Raspberry Pi Imager auf die USB-SSD schreiben.
  2. SSD, LAN, Monitor und Tastatur mit dem Pi verbinden und starten.
  3. Den ersten Login entsprechend den Hinweisen des jeweiligen Debian-Images einrichten. Einen eigenen Benutzer mit starkem Passwort verwenden und SSH nur bei Bedarf aktivieren.
  4. Auf dem Pi als root anmelden (gegebenenfalls mit su -) und aktualisieren:
apt update && apt full-upgrade -y
apt install -y git ca-certificates openssh-server
hostnamectl set-hostname pve-pi4
reboot

Für Proxmox muss der Hostname korrekt auf die lokale Management-IP auflösbar sein. Dazu in /etc/hosts einen zur eigenen Umgebung passenden Eintrag anlegen, beispielsweise 192.168.1.50 pve-pi4.home.arpa pve-pi4 (IP-Adresse anpassen). Idealerweise im Router eine feste DHCP-Zuweisung einrichten.

3. ARM64 und Kernel prüfen

Nach dem Neustart als root ausführen:

dpkg --print-architecture
uname -r
hostname -f
ip -br addr

Die Architektur muss arm64 sein. Der Kernel muss auf dem Pi starten und die benötigten Funktionen bereitstellen. Der Community-Installer nennt Kernel 6.12 oder neuer als getestete Basis; das ist keine allgemeine Kompatibilitätsgarantie.

4. Community-Installer prüfen und starten

Sicherheitsregel: Das GitHub-Projekt ist nicht offiziell und verändert Netzwerk, APT-Paketquellen und Systempakete. Vor dem Ausführen insbesondere build.sh und die Dateien unter scripts/ lesen. Der Installer soll nur auf einem entbehrlichen Testsystem eingesetzt werden.

cd /root
git clone https://github.com/topa-LE/pve-arm64-rpi-control.git
cd pve-arm64-rpi-control
git rev-parse HEAD
less build.sh
less scripts/06_add_proxmox_repo.sh
less scripts/07_install_proxmox_ve.sh

Die ausgegebene Commit-ID für eine spätere Wiederholung dokumentieren. Erst nach Prüfung des gesamten Installers und seiner weiteren Skripte starten:

bash ./build.sh

Der Installer richtet unter anderem das PXVIRT-Repository, angepasste Proxmox-Pakete und die Netzwerk-Bridge vmbr0 ein. Nach Abschluss und Prüfung der Netzwerk-Konfiguration neu starten:

reboot

Achtung: Der Wechsel der Management-IP von eth0 auf vmbr0 kann die SSH-Verbindung unterbrechen. Bei Problemen Monitor und Tastatur nutzen. Kein WLAN als primäre Bridge-Verbindung verwenden.

5. Proxmox-Weboberfläche öffnen

Im Browser aufrufen: https://<PI-IP>:8006

Falls die Installation erfolgreich war, mit root und dem eigenen Root-Passwort im Realm Linux PAM anmelden. Ein selbstsigniertes TLS-Zertifikat kann anfangs eine Browserwarnung auslösen; Zertifikat vor dem Bestätigen prüfen.

Auf dem Pi grundlegende Prüfungen ausführen:

pveversion
systemctl status pveproxy --no-pager
ip -br addr
ls -l /dev/kvm

Fehlt /dev/kvm, sind hardwarebeschleunigte VMs möglicherweise nicht nutzbar. ARM64-LXC-Container sind für den Raspberry Pi meist die sinnvollere Testlast.

6. Sicherheit und Grenzen

  • Keinen Internet-Portforward auf 8006 oder SSH einrichten; Zugriff nur im vertrauenswürdigen LAN oder über VPN.
  • Keine Standardpasswörter verwenden. SSH bevorzugt mit Schlüsseln absichern.
  • Updates der Drittanbieter-Pakete bewusst prüfen; das Projekt ist nicht Teil des offiziellen Proxmox-Supports.
  • Nur ARM64-kompatible Container/VM-Images verwenden. x86-VMs laufen nicht nativ auf dem Pi.
  • Keine produktiven Daten speichern; regelmäßige externe Backups verwenden.

Dokumentationsstand: 19. Oktober 2026. Community-Installer wurde für diese Anleitung nicht praktisch auf Hardware getestet.

Back to top