Skip to main content

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

In dieser Anleitung wird ein Raspberry Pi 4 (mit 8 GB)GB RAM als kleiner Proxmox-Test-NodeTestserver

Basis:eingerichtet. Als Betriebssystem dient Debian 13 (Trixie) ARM64,ARM64 mit einem Raspberry-Pi-kompatiblerkompatiblen KernelDebian-Kernel. undDie angepassteProxmox-Komponenten Proxmox/PXVIRT-Pakete.werden Einsatz:über ausschließlichdas Homelab/Test.inoffizielle Community-Projekt Pimox/PXVIRT installiert.

Wichtig: DerProxmox VE unterstützt ARM64 offiziell, jedoch nicht den Raspberry Pi 44. wirdDiese vonInstallation Proxmoxist VEdaher nichtausschließlich offiziellfür unterstützt. Der offizielle ARM64-ISO-InstallerHomelab- und PVE-KernelTestumgebungen sind kein direkt nutzbarer Installationsweg auf dem Pi. Die hier verwendete Community-Lösung kann sich jederzeit ändern.gedacht.

1. Voraussetzungen und Downloads

Quellenkennzeichnung: Betriebssystem und Schreibwerkzeug stammen von Debian bzw. Raspberry Pi. Die für den Pi angepasste Proxmox-Installation ist nicht offiziell und erfordert Software eines unabhängigen Community-Entwicklers. Es gibt für diesen Weg keinen vollständig offiziellen Proxmox-Download.

  • Raspberry Pi 4 mit 8 GB RAM,RAM
  • Geeignetes passendes Netzteil, LAN-Kabel und möglichst USB-C-Netzteil
  • USB-SSD (stattempfohlen) microSD).oder microSD-Karte
  • LAN-Verbindung zum Netzwerk
  • Monitor und Tastatur für die Ersteinrichtung
  • Debian 13 ARM64

2. Offizielle Downloads

Debian 13 ARM64

Debian stellt eigene ARM64-Datenträgerimages für den Raspberry Pi 4 zur Verfügung. Es handelt sich nicht um ISO-Dateien.

OffiziellOffizieller (Debian):Debian-Download: 
Debian 13 Trixie – Raspberry Pi ARM64 Cloud-Image

Offizielles Downloadverzeichnis:
Debian Cloud Images – Trixie

Offizielle Debian-Dokumentation:
Debian Wiki – Raspberry Pi Images

Hinweis: Das Image (täglicherwird Build);täglich Debian-Image-Dokumentation.erstellt Hinweis:und Fürist solchekein Buildsseparat wurdengetestetes BootproblemeRaspberry-Pi-Release. gemeldet.Die VorSHA512-Prüfsumme demsollte weiterenanhand Einrichtender offiziellen Dateien im Downloadverzeichnis überprüft werden.

Raspberry Pi Imager

Zum Schreiben des Images verwenden wir den erfolgreichenoffiziellen Start testen.

Offiziell (Raspberry Pi):Pi Imager.

Raspberry Pi Imager herunterladen

zum

Proxmox SchreibenVE desund entpacktenCommunity-Anpassungen

Images.

Die Alternativeoriginale Betriebssystembasis:Proxmox-ARM64-Version ist für andere ARM-Systeme vorgesehen. Für den Raspberry Pi OSverwenden Litewir 64-bit,das Debian-13-basiertinoffizielle Projekt Pimox ARM64 RPI Control.

Offizielle Proxmox-Informationen:
Proxmox VE Downloads

(nicht

Inoffizielles identischCommunity-Projekt:
Pimox mitARM64 reinemRPI Debian;Control für– denGitHub

hier

Achtung: beschriebenenDer Community-Installer nichtverwendet alsein kompatibelexternes verifiziert).

InoffiziellPXVIRT-Paketrepository. (Drittanbieter,Die keindort Proxmox-Download):bereitgestellten Community-Installer:Pakete pve-arm64-rpi-control (Installationsanleitung und Quellcode). Offizielle Proxmox-ARM64-Informationen geltenstammen nicht alsvon Raspberry-Pi-Kompatibilitätsfreigabe.Proxmox

Hinweis:oder DasDebian. Debian-ImageEine istInstallation ein täglich gebautes, komprimiertes Datenträgerimage, keine ISO. Prüfsummenausschließlich aus dem offiziellen Debian-Downloadverzeichnis prüfen. Archiv entpacken und dieProxmox-Quellen enthaltene Datenträgerdateiist auf diediesem SSDWeg schreiben.nicht Dabei wird der ausgewählte Datenträger vollständig überschrieben.möglich.

2.3. Debian 13 installieren

  1. Das Debian-13-ARM64-Image herunterladen,herunterladen.
  2. Die entpackenSHA512-Prüfsumme undkontrollieren.
  3. Das heruntergeladene TAR.XZ-Archiv entpacken.
  4. Raspberry Pi Imager öffnen.
  5. Unter Betriebssystem „Use Custom“ auswählen.
  6. Die entpackte Datei disk.raw auswählen.
  7. USB-SSD als Zieldatenträger auswählen.
  8. Image auf den Datenträger schreiben.
  9. SSD mit dem Raspberry Pi Imagerverbinden und starten.

Achtung: Beim Schreiben werden sämtliche Daten auf diedem USB-SSDausgewählten schreiben.

SSD,Datenträger LAN,gelöscht.

4. Debian vorbereiten

Beim ersten Start lokal über Monitor und Tastatur mitanmelden. dem Pi verbinden und starten.

Den ersten Login entsprechend den Hinweisen des jeweiligenDie Debian-Raspberry-Pi-Images einrichten.werden Einenlaut eigenen BenutzerDebian-Dokumentation mit starkemeinem zunächst passwortlosen lokalen root-Zugang ausgeliefert.

Deshalb direkt ein sicheres root-Passwort verwendensetzen:

und
passwd
SSH

Anschließend nurdas bei Bedarf aktivieren.

Auf dem Pi als root anmelden (gegebenenfalls mit su -) undBetriebssystem aktualisieren: 
apt update
&& apt full-upgrade
-y

Benötigte Pakete installieren:

apt install -ygit gitcurl ca-certificates openssh-server

Einen normalen Benutzer für den SSH-Zugriff erstellen:

adduser piadmin

Für SSH möglichst eine Schlüsselanmeldung verwenden. Eine direkte root-Anmeldung per SSH sollte deaktiviert bleiben. Für administrative Arbeiten kann nach der Anmeldung mit piadmin zu root gewechselt werden:

su -

Hostname festlegen

hostnamectl set-hostname pve-pi4
reboot

Für Proxmox mussIn der Hostname korrekt auf die lokale Management-IP auflösbar sein. Dazu inDatei /etc/hosts muss der Hostname auf die Management-IP des Raspberry Pi auflösbar sein.

Beispiel für einen zurzusätzlichen eigenenEintrag:

Umgebung passenden Eintrag anlegen, beispielsweise 
192.168.1.178.50 pve-pi4.home.arpa pve-pi4
(

Die IP-Adresse anpassen).muss Idealerweisean imdas Routereigene eineNetzwerk angepasst werden. Eine feste DHCP-Zuweisung einrichten.im Router wird empfohlen.

3.5. ARM64System und Kernel prüfenkontrollieren

NachPrüfen, demob NeustartDebian tatsächlich als rootARM64-System ausführen:läuft:

dpkg --print-architecture
uname -r
hostnamecat -f
ip -br addr/etc/os-release

DieErwartete ArchitekturArchitektur:

muss
arm64
arm64 sein.

Der KernelRaspberry mussPi aufverwendet den mit dem PiDebian-Image startengelieferten kompatiblen Kernel und die benötigtenbenötigte FunktionenBoot-Firmware. bereitstellen.Ein Deroffizieller Proxmox-Kernel muss hier nicht manuell installiert werden.

Das Community-InstallerProjekt nennt Kernel 6.12 oder neuer als getestete Basis;Grundlage. Die tatsächlich installierte Kernel-Version muss deshalb vorab geprüft werden.

Zusätzlich die Netzwerkverbindung kontrollieren:

ip -br addr
hostname -f

6. Community-Proxmox installieren

Die folgenden Schritte erfolgen als root.

Zuerst das istCommunity-Repository 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.herunterladen:

cd /root
git clone https://github.com/topa-LE/pve-arm64-rpi-control.git
cd pve-arm64-rpi-control

Den heruntergeladenen Commit dokumentieren:

git rev-parse HEAD

Sicherheitshinweis: Vor der Ausführung müssen build.sh und die Skripte im Verzeichnis scripts/ kontrolliert werden. Besonders wichtig sind Änderungen an APT-Quellen, Paket-Signaturschlüsseln, Passwörtern, Kernel und Netzwerk.

Die betreffenden Dateien können beispielsweise mit less gelesen werden:

less build.sh
less scripts/06_add_proxmox_repo.sh
less scripts/07_install_proxmox_ve.sh

Auch alle übrigen vom Installer aufgerufenen Skripte müssen vorab geprüft werden.

Wichtig: Die ausgegebeneim Commit-IDCommunity-Projekt fürangebotenen eineSkripte späterezur WiederholungVorbereitung dokumentieren.eines Images können ein bekanntes Standardpasswort konfigurieren. Diese Variante wird hier bewusst nicht verwendet.

Installation starten

Erst nachnachdem Prüfungder desInstaller, gesamtenseine InstallersAbhängigkeiten und seinerdas weiterenexterne SkriptePXVIRT-Repository starten:als vertrauenswürdig bewertet wurden:

bash ./build.sh

Der Installer richtetsoll unterdie anderem das PXVIRT-Repository, angepasstebenötigten Proxmox-PaketeKomponenten installieren und dieeine Netzwerk-Bridge vorbereiten. Dabei wird die bisherige Netzwerkkonfiguration verändert.

Die vorgesehene Netzwerkkonfiguration lautet:

eth0  = physischer Netzwerkanschluss
vmbr0 = Netzwerk-Bridge mit Management-IP
ein.

Nach Abschluss unddie PrüfungNetzwerkkonfiguration prüfen. Ein Monitor mit Tastatur sollte verfügbar bleiben, falls der Netzwerk-KonfigurationNetzwerkzugriff neunach starten:dem Neustart ausfällt.

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.7. Proxmox-Weboberfläche öffnen

ImNach dem Neustart die IP-Adresse des Raspberry Pi im Browser aufrufen:

https://<PI-IP>:192.168.178.50:8006

Die Adresse muss an das eigene Netzwerk angepasst werden.

FallsAnmeldung diebei Installationerfolgreicher erfolgreichInstallation:

war,
  • Benutzername: mitroot
  • Passwort: rootdas undzuvor demgesetzte eigenenroot-Passwort
  • Realm: Root-Passwort im Realm Linux PAM
anmelden.

Das Einanfänglich selbstsigniertesselbstsignierte TLS-Zertifikat kann anfangs eine Browserwarnung auslösen;verursachen. Das Zertifikat vor dem Bestätigen prüfen.überprüfen.

8. Installation überprüfen

AufFolgende demBefehle Pizeigen grundlegendedie Prüfungeninstallierte ausführen:Version, den aktiven Kernel und den Status der Weboberfläche:

pveversion -v
uname -r
systemctl status pveproxy --no-pager
ip -br addr

Optional prüfen, ob Hardware-Virtualisierung bereitgestellt wird:

ls -l /dev/kvm

FehltIst /dev/kvm, sindnicht hardwarebeschleunigtevorhanden, VMssteht möglicherweise nichtkeine nutzbar.KVM-Beschleunigung ARM64-LXC-Containerzur sindVerfügung. fürDas denmuss Raspberrygetrennt Piuntersucht meist die sinnvollere Testlast.werden.

6.9. Sicherheit und GrenzenEinschränkungen

  • KeinenNur Internet-Portforwardfür aufHomelab und Testumgebungen verwenden.
  • Port 8006 oderund SSH einrichten;nicht Zugriffins nurInternet im vertrauenswürdigen LAN oder über VPN.weiterleiten.
  • Keine Standardpasswörter verwenden. SSHSSH-Zugang bevorzugt mit öffentlichen Schlüsseln absichern.
  • UpdatesKeine derbekannten Drittanbieter-Paketeoder bewusstvoreingestellten prüfen;Passwörter dasverwenden.
  • Community-Paketupdates Projektvor istInstallation überprüfen.
  • Den funktionierenden Debian-Boot-Kernel nicht Teilunkontrolliert des offiziellen Proxmox-Supports.ersetzen.
  • NurFür Container und native VMs ARM64-kompatible Container/VM-Images verwenden.
  • Vor x86-VMsgrößeren laufenÄnderungen nichtein nativBackup aufder demSSD Pi.erstellen.
  • Keine produktiven Daten speichern;auf regelmäßigedem externeTest-Node Backups verwenden.speichern.

Empfehlung: Für erste Tests eignen sich schlanke ARM64-LXC-Container. KVM-VMs können abhängig von Kernel und Plattformfunktionen eingeschränkt sein.

10. Weiterführende LinksDokumentation

Dokumentationsstand: 19. Oktober 2026.
Debian- und Proxmox-Quellen überprüft. Die Community-InstallerInstallation wurde für diese Anleitung nicht praktisch auf eigener Raspberry-Pi-Hardware getestet.

Back to top