Skip to main content

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

In dieserDiese Anleitung wirdbeschreibt eindie Installation einer Proxmox-ähnlichen Virtualisierungsumgebung auf einem Raspberry Pi 4 mit 8 GB RAMRAM.

als

Grundlage kleiner Proxmox-Testserver eingerichtet. Als Betriebssystem dientist Debian 13 (Trixie) ARM64 mit einem Raspberry-Pi-kompatiblen Debian-Linux-Kernel. Die Proxmox-Komponenten werden über das inoffizielle Community-Projekt Pimox/PXVIRT installiert.

Wichtig: Proxmox VE unterstützt ARM64 offiziell, jedoch nicht den Raspberry Pi 4. Diese Installation ist daher ausschließlich für Homelab- und Testumgebungen gedacht.bereitgestellt.

1. Voraussetzungen

  • Raspberry Pi 4 mit 8 GB RAM
  • Geeignetes USB-C-Netzteil
  • USB-SSD (empfohlen)mit odermindestens microSD-Karte32 GB
  • LAN-VerbindungNetzwerkkabel und Internetverbindung
  • Linux-PC zum NetzwerkVorbereiten der SSD
  • Monitor und Tastatur für die Ersteinrichtung
  • Debian 13 ARM64

Eine USB-SSD ist für Container und virtuelle Maschinen deutlich besser geeignet als eine microSD-Karte.

2. Offizielle Downloads

Debian 13 ARM64

herunterladen

DebianDas stellt eigene ARM64-DatenträgerimagesDebian-Image für den Raspberry Pi 4wird zurals Verfügung.TAR.XZ-Archiv Esbereitgestellt. handeltEine sichISO-Datei wird nicht um ISO-Dateien.benötigt.

Offizieller Debian-Download:
Debian 13 TrixieARM64 – Raspberry Pi ARM64 ImageDownloadverzeichnis

OffiziellesAuf Downloadverzeichnis:
Debiandem CloudLinux-PC Imagesein –Terminal Trixieöffnen und zu root wechseln:

su -

Benötigte Werkzeuge installieren:

apt update
apt install curl ca-certificates xz-utils tar

Arbeitsverzeichnis erstellen:

mkdir -p /root/raspi-pve
cd /root/raspi-pve

Debian-Image herunterladen:

curl -fL --retry 3 -O https://cloud.debian.org/images/cloud/trixie/daily/latest/debian-13-raspi-arm64-daily.tar.xz

Prüfsummen herunterladen:

curl -fL --retry 3 -O https://cloud.debian.org/images/cloud/trixie/daily/latest/SHA512SUMS

Download überprüfen:

sha512sum --ignore-missing -c SHA512SUMS

Nur fortfahren, wenn die Prüfsummenprüfung erfolgreich abgeschlossen wurde.

OffizielleArchiv Debian-Dokumentation:
Debianentpacken:

Wiki
tar –-xJf Raspberrydebian-13-raspi-arm64-daily.tar.xz
Pi

Im ImagesVerzeichnis sollte anschließend die Datei disk.raw vorhanden sein.

Hinweis: DasFür Imagedie wird täglich erstellt und ist kein separat getestetes Raspberry-Pi-Release. Die SHA512-Prüfsumme sollte anhand der offiziellen Dateien im Downloadverzeichnis überprüft werden.

Raspberry Pi Imager

Zum Schreiben des Debian-13-Images verwendenwurde wirein denBootproblem offiziellenauf dem Raspberry Pi Imager.4 gemeldet. Falls das Image nicht startet, siehe den Abschnitt Fehlerbehebung.

Raspberry

3. PiDebian Imagerauf herunterladen

die

ProxmoxSSD VE und Community-Anpassungen

schreiben

Die originaleUSB-SSD Proxmox-ARM64-Versionan den Linux-PC anschließen und alle angeschlossenen Datenträger anzeigen:

lsblk -o NAME,SIZE,MODEL,TYPE,MOUNTPOINTS

Beispiel:

sda    1.8T  Samsung SSD       disk
├─sda1
└─sda2
sdb  119.2G  USB SSD           disk
├─sdb1
└─sdb2

Im Beispiel ist für/dev/sdb anderedie ARM-Systemegewünschte vorgesehen. Für den Raspberry Pi verwenden wir das inoffizielle Projekt Pimox ARM64 RPI Control.

Offizielle Proxmox-Informationen:
Proxmox VE Downloads

Inoffizielles Community-Projekt:
Pimox ARM64 RPI Control – GitHubUSB-SSD.

Achtung: Der Community-Installerfolgende verwendetVorgang einlöscht externesalle PXVIRT-Paketrepository.Daten auf dem ausgewählten Datenträger. Die dortGerätebezeichnung bereitgestelltenmuss Paketeunbedingt stammenstimmen.

nicht

Falls vonPartitionen Proxmoxder oderZiel-SSD Debian.eingehängt Einesind, Installationdiese ausschließlichvor ausdem offiziellenSchreiben Debian-aushängen.

und

Das Proxmox-QuellenZielgerät istinteraktiv auswählen:

read -r -p "Zieldatenträger (z.B. /dev/sdb): " ZIEL

test -b "$ZIEL" || exit 1
test "$(lsblk -dn -o TYPE "$ZIEL")" = "disk" || exit 1

lsblk -o NAME,SIZE,MODEL,MOUNTPOINTS "$ZIEL"

Nach erneuter Kontrolle das Schreiben bestätigen:

read -r -p "Alle Daten auf diesem$ZIEL Weglöschen? nichtJA möglich.eingeben:

3." DebianOK 13if installieren

[
  1. Debian-13-ARM64-Image"$OK" herunterladen.
  2. Die= SHA512-Prüfsumme"JA" kontrollieren.
  3. Das]; heruntergeladenethen TAR.XZ-Archivdd entpacken.
  4. Raspberry Pi Imager öffnen.
  5. Unter Betriebssystem „Use Custom“ auswählen.
  6. Die entpackte Datei if=disk.raw auswählen.
  7. USB-of="$ZIEL" bs=4M status=progress conv=fsync sync fi

Nach erfolgreichem Abschluss die SSD alssicher Zieldatenträgerentfernen auswählen.

Image auf den Datenträger schreiben.SSDund mit dem Raspberry Pi verbinden und starten.

Achtung: Beim Schreiben werden sämtliche Daten auf dem ausgewählten Datenträger gelöscht.verbinden.

4. Debian vorbereitenerstmals starten

Beim

  1. SSD erstenam StartRaspberry lokalPi überanschließen.
  2. Netzwerkkabel verbinden.
  3. Monitor und Tastatur anmelden.anschließen.
  4. Raspberry Pi einschalten.
  5. Debian vollständig starten lassen.

Die Debian-Raspberry-Pi-Images werden laut Debian-Dokumentation mit einemermöglichen zunächst passwortloseneine lokalenlokale root-ZugangAnmeldung ausgeliefert.als root ohne Passwort.

DeshalbDirekt direktnach der Anmeldung ein sichereseigenes root-Passwort setzen:festlegen:

passwd

Anschließend das BetriebssystemSystem aktualisieren:

apt update
apt full-upgrade

Benötigte Pakete installieren:

apt install git curl ca-certificates openssh-server nano less

Einen normalen Benutzer für denSSH SSH-Zugriff erstellen:anlegen:

adduser piadmin

Für SSH möglichst einemit SchlüsselanmeldungSchlüsselauthentifizierung verwenden.einrichten. Eine direkte root-Anmeldung per SSH sollteist deaktiviertfür bleiben.diese FürAnleitung administrativenicht Arbeiten kann nach der Anmeldung mit piadmin zu root gewechselt werden:erforderlich.

su -

Hostname festlegenkonfigurieren

hostnamectl set-hostname pve-pi4

InDie derHostdatei Dateibearbeiten:

nano /etc/hosts muss der Hostname auf die Management-IP des Raspberry Pi auflösbar sein.

Beispiel für einen zusätzlichen Eintrag:

192.168.178.50 pve-pi4.home.arpa pve-pi4

Die IP-Adresse mussentsprechend andem das eigeneeigenen Netzwerk angepasstanpassen. werden.Am Einebesten im Router eine feste DHCP-Zuweisung imfür Routerden wirdRaspberry empfohlen.Pi erstellen.

5. System

Architektur und Kernel kontrollieren

Prüfen, ob Debian tatsächlich als ARM64-System läuft:

prüfen 
dpkg --print-architecture
uname -r
cat /etc/os-release
ip -br addr

ErwarteteDie Architektur:

arm64

Der Raspberry Pi verwendet den mit dem Debian-Image gelieferten kompatiblen Kernel und die benötigte Boot-Firmware. Ein offizieller Proxmox-KernelArchitektur muss hierarm64 nichtsein. manuell installiert werden.

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

ZusätzlichNach dieeinem NetzwerkverbindungKernel-Update kontrollieren:den Raspberry Pi neu starten:

ip -br addr
hostname -freboot

6.5. Community-ProxmoxProxmox-Installation installierenvorbereiten

Die folgendenProxmox-Pakete Schrittewerden erfolgenüber das Projekt Pimox ARM64 RPI Control installiert.

Pimox ARM64 RPI Control – GitHub

Am Raspberry Pi als root.root anmelden oder aus einer normalen SSH-Sitzung mit su - zu root wechseln.

Zuerst das Community-Repository herunterladen:

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

Den heruntergeladenenVerwendeten Commit dokumentieren:

git rev-parse HEAD

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

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

less build.sh
less scripts/02_prepare_system.sh
less scripts/04_configure_network_bridge.sh
less scripts/05_enable_vmbr0.sh
less scripts/06_add_proxmox_repo.sh
less scripts/07_install_proxmox_ve.sh

Auch alle übrigen vomDer Installer aufgerufenennutzt Skripteein müssenexternes vorabPXVIRT-Repository. geprüftAußerdem werden.verändert er die Netzwerkkonfiguration. Deshalb wird die Installation hier in zwei Abschnitten durchgeführt.

6. Netzwerk-Bridge einrichten

Wichtig: DieDiesen imAbschnitt Community-Projektdirekt angebotenenam SkripteRaspberry zurPi Vorbereitungmit einesMonitor Imagesund könnenTastatur einausführen. bekanntesBei Standardpassworteiner konfigurieren.SSH-Verbindung Diese Variante wird hier bewusst nicht verwendet.

Installation starten

Erst nachdemkann der Installer,Netzwerkzugriff seinewährend Abhängigkeitender undUmstellung dasverloren externegehen.

PXVIRT-Repository

Systemprüfung alsausführen:

vertrauenswürdig
cd bewertet/root/pve-arm64-rpi-control
wurden:bash scripts/00_system_check.sh
bash scripts/01_hardware_report.sh

Basissystem vorbereiten:

bash ./build.scripts/02_prepare_system.sh

DerDieses InstallerSkript sollinstalliert Netzwerkwerkzeuge und deaktiviert unter anderem WLAN und Bluetooth.

Netzwerkkonfiguration vorbereiten:

bash scripts/04_configure_network_bridge.sh

Prüfen, ob die benötigtenkabelgebundene Proxmox-KomponentenSchnittstelle installierentatsächlich undeth0 eineheißt:

Netzwerk-
ip -br addr
ip route

Anschließend die Bridge vorbereiten. DabeiIm folgenden Beispiel wird eth0 verwendet:

IFACE=eth0 bash scripts/05_enable_vmbr0.sh

Das Skript richtet die Bridge vmbr0 ein und übernimmt die bisherige NetzwerkkonfigurationIPv4-Adresse verändert.und das Standardgateway.

DieKonfiguration vorgesehene Netzwerkkonfiguration lautet:kontrollieren:

eth0cat =/etc/network/interfaces
physischer

Wenn NetzwerkanschlussIP-Adresse, vmbr0Gateway =und Netzwerk-BridgeSchnittstelle mitstimmen, Management-IPden Raspberry Pi neu starten:

reboot

Nach Abschlussdem Neustart sollte die NetzwerkkonfigurationManagement-IP prüfen.auf Einvmbr0 Monitorliegen.

mit

7. TastaturProxmox-Pakete sollteinstallieren

verfügbar bleiben, falls der Netzwerkzugriff nach

Nach dem Neustart ausfällt.erneut als root anmelden.

Netzwerkverbindung prüfen:

ip -br addr
ip route
apt update

Die Installation erst fortsetzen, wenn die Netzwerkverbindung funktioniert.

In das Projektverzeichnis wechseln:

cd /root/pve-arm64-rpi-control

PXVIRT-Paketrepository einrichten:

bash scripts/06_add_proxmox_repo.sh

Verfügbare Proxmox-Pakete kontrollieren:

apt-cache policy proxmox-ve

Danach die angepassten Proxmox-Komponenten installieren:

bash scripts/07_install_proxmox_ve.sh

Nach erfolgreicher Installation die installierte Version kontrollieren:

pveversion -v

Raspberry Pi neu starten:

reboot

7.8. Proxmox-Weboberfläche öffnen

Nach dem Neustart kann die IP-AdresseWeboberfläche desüber RaspberryPort Pi8006 imaufgerufen Browserwerden.

aufrufen:

Beispiel:

https://192.168.178.50:8006

Die Adresse muss an das eigene Netzwerk angepasst werden.

Anmeldung bei erfolgreicher Installation:Login:

  • Benutzername:Benutzer: root
  • Passwort: dasDas zuvor gesetzte root-Passwort
  • Realm: Linux PAM

DasDie anfänglichWeboberfläche selbstsignierteverwendet anfangs möglicherweise ein selbstsigniertes TLS-Zertifikat kann eine Browserwarnung verursachen. Das Zertifikat vor dem Bestätigen überprüfen.Zertifikat.

8.9. InstallationSystem überprüfen

FolgendeProxmox-Version Befehle zeigen die installierte Version, den aktiven Kernel und den Status der Weboberfläche:anzeigen:

pveversion -v

Kernel prüfen:

uname -r

Weboberfläche kontrollieren:

systemctl status pveproxy --no-pager

Netzwerk anzeigen:

ip -br addr

OptionalKVM-Verfügbarkeit prüfen, ob Hardware-Virtualisierung bereitgestellt wird:prüfen:

ls -l /dev/kvm

IstArbeitsspeicher und Datenträger prüfen:

free -h
df -h /dev/kvm
lsblk

Falls das Root-Dateisystem nicht vorhanden,die stehtvolle möglicherweiseSSD-Kapazität keine KVM-Beschleunigung zur Verfügung. Dasverwendet, muss getrenntdie untersuchtPartitionierung separat geprüft und bei Bedarf erweitert werden.

9.10. SicherheitHinweise und EinschränkungenFehlerbehebung

  • Nur

    Debian fürstartet Homelabnicht

    Für die Debian-13-Raspberry-Pi-Cloud-Images existiert ein gemeldeter Bootfehler mit der Partitionstabelle beziehungsweise Firmware auf dem Raspberry Pi 4.

    Debian Bug #1130560

    Bei einem Bootproblem zuerst die Fehlermeldung und Testumgebungenden verwenden.

  • PortStand 8006des Bugs prüfen. Ein erneutes Schreiben desselben Images behebt einen Fehler im Image selbst nicht.

    Weboberfläche nicht erreichbar

    Zuerst den Netzwerkstatus und SSHden nichtProxmox-Proxy insprüfen:

    Internet
    ip weiterleiten.
  • SSH-Zugang-br bevorzugtaddr mitip öffentlichenroute Schlüsselnsystemctl absichern.
  • Keinestatus bekanntenpveproxy oder--no-pager voreingestellten

    Kernel Passwörterund verwenden.

  • Community-PaketupdatesVirtualisierung vor Installation überprüfen.

  • Den funktionierenden Debian-Raspberry-Pi-Boot-Kernel nicht unkontrolliert ersetzen.

  • Für ARM64-Container eignen sich für erste Tests. Virtuelle Maschinen benötigen passende ARM64-Gastsysteme und nativegegebenenfalls VMsKVM. ARM64-kompatible

    Sicherheit

    Images
    • Port 8006 nur im internen Netzwerk erreichbar machen.
    • SSH möglichst auf Schlüsselanmeldung umstellen.
    • Keine Standardpasswörter verwenden.
    • Community-Pakete und Updates vor der Installation prüfen.
    • Vor größeren Änderungen ein Backup der SSD erstellen.
    • KeineDen produktivenRaspberry DatenPi aufnur demfür Test-Node speichern.und Homelab-Zwecke einsetzen.

    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.11. Weiterführende Dokumentation

    Dokumentationsstand: 19.Stand: Oktober 2026.
    Debian- und Proxmox-Quellen überprüft. Die Community-InstallationInstallationsweg wurdefür Testsysteme; auf dem beschriebenen Raspberry Pi 4 nicht auf eigener Raspberry-Pi-Hardwareeigenständig getestet.

Back to top