Installation Proxmox VE - jens-maus/RaspberryMatic GitHub Wiki

Setzt man als Virtualisierungsumgebung Proxmox Virtual Environment (VE) ein, kann man mit den folgenden Schritten eine Grundinstallation einer virtuellen RaspberryMatic vornehmen. Diese virtuelle Maschine (VM) kann im folgenden entweder als vollwertige QEmu/KVM-basierte VM/OVA oder aber auch als leichtgewichtiger CT/LXC Container umgesetzt werden. Des Weiteren gilt zu beachten, dass man einerseits die Installation teilautomatisiert durchführen lassen kann oder aber auch komplett manuell, vom Download der passenden Image Datei bis hin zur Vergrößerung der virtuellen Festplattengröße.

Bei dem wird entweder eine Proxmox VE Standardinstallation unter einer x86-basierter Hardware (z.B. IntelNUC) als Host unterstützt, jedoch auch eine manuell vorgenommene ARM-basierte Proxmox VE Installation z.B. unter einem performanten SBC wie einem RaspberryPi5 via ARM-Ports von Proxmox VE (siehe https://github.com/jiangcuo/Proxmox-Port). Zu Letzterem existiert unter dem Abschnitt Proxmox VE (ARM) Grundinstallation auch eine Kurzanleitung wie man z.B. unter einem RaspberryPi5 eine solche ARM-basierte Proxmox VE Grundinstallation vornehmen kann.

Um RaspberryMatic als virtuelle Maschine (entweder als VM/OVA oder CT/LXC Container) innerhalb eines x86-basierten oder ARM-basierten Proxmox VE Systems zu betreiben, kann man innerhalb einer bereits lauffähigen Proxmox VE Umgebung wie folgt vorgehen. Hierbei gilt zu beachten, das für die folgenden Installationsschritte der Proxmox VE Host über eine funktionierende Internetverbindung verfügen muss, da der notwendige Installationsskript sowie die Image-Datei automatisch heruntergeladen wird:

1. Proxmox Shell starten: Nach einloggen in der Proxmox Weboberfläche kann man via Rechtsklick auf sein Proxmox-System (hier: pve) dort die "Shell" aufrufen um in die Kommandozeile von Proxmox zu gelangen:

2. Installationskommando ausführen: Um die Installation zu starten sollte man im nächsten Schritt das folgende Kommando innerhalb der Proxmox-Shell eingeben und dann mit Enter entsprechend bestätigen:

   wget -qO - https://raspberrymatic.de/install-proxmox.sh | bash -

   bzw. wenn man als nicht-root user mit sudo-rechten via SSH verbunden ist, dann via

   sudo sh -c "wget -qO - https://raspberrymatic.de/install-proxmox.sh | bash -"

   

3. Virtualisierungstyp wählen: Nach Ausführen des Installationskommandos wird man nach kurzer Ladezeit als erstes aufgefordert die Art der Virtualisierung auszuwählen ('Space' zur Auswahl nutzen):

   Hierbei gilt zu beachten das generell die Virtualisierung als Full Virtual Machine / OVA zu bevorzugen ist, da diese es in den folgenden Schritten es nicht notwendig macht gewisse Pakete innerhalb des Proxmox VE Systems selbst zu installieren damit die für eine CCU/RaspberryMatic notwendigen Funkmodule (z.B. HmIP-RFUSB oder RPI-RF-MOD) genutzt werden können. Möchte man hingegen RaspberryMatic leichtgewichtigen LXC Container (Lightweight LXC Container) betreiben um hierüber ggf. einfacher/direkter auf lokale Schnittstellen (z.B. GPIO, UART, etc.) des Hostsystems zuzugreifen, so kann man die Anleitung unter Installation als CT / LXC fortführen.

Hat man als Virtualisierungstyp Full Virtual Machine bzw. "VM" / "OVA" gewählt, so sollte man die folgenden weiteren Schritte des Installationsskriptes nacheinander durchgehen:

1. Version auswählen: Nach Ausführen des Installationskommandos wird man nach kurzer Ladezeit aufgefordert eine Version für die Installation auszuwählen:

   ⚠️ Hinweis: Bei der Auswahl der zu installierenden RaspberryMatic Version wird zwischen release und snapshot Versionen unterschieden. Bei letzterem muss beachten werden, dass es sich hierbei um experimentelle Entwicklungssnapshots handelt die entsprechend "instabil" sein könnten. Für eine produktive RaspberryMatic Umgebung sollte man daher bevorzugt auf die release Versionen setzen.

2. Storage auswählen: Hat man die zu installierende Version ausgewählt, wird man im nächsten Schritt dazu aufgeforder den entsprechenden Storage auszuwählen der für die VM im späteren Verlauf verwendet werden soll (mit Taste 'Space' auswählen):

   ⚠️ Hinweis: Diese Aufforderung kommt nur wenn man mehr als ein VM Storage für Proxmox VE konfiguriert hat.

3. Userdiskgröße wählen: Nun wird man im folgenden zur Eingabe des gewünschten virtuellen Speicherplatzes für die Userdisk des RaspberryMatic systems gebeten in welcher später alle nutzerbezogenen Konfigurationsdateien und Zusatzpakete installiert werden:

   Als Minimum ist hier 4 GB definiert, wobei eine Größe von 6 GB auch für größere Installationen ausreichend sein sollten. Zu beachten gilt hierbei auch noch das es sich wie gesagt um virtuellen Speicherplatz handelt. D.h. selbst bei Eingabe eines größeren Wertes wird zur jeweiligen Zeit auf dem Hostsystem lediglich der aktuell verbrauchte Platz allokiert.

4. RF-Funkmodul auswählen: Als letzten Schritt vor der Installation muss man noch ein etwaig bereits mit dem Proxmox via USB verbundenes HomeMatic/homematicIP Funkmodul auswählen (mit Taste 'Space' auswählen), welches der VM im späteren Verlauf dann automatisch zugewiesen wird. Hat man (noch) kein Funkmodul an den Proxmox Host angeschlossen kann man dies auch später manuell noch erledigen und dieser Schritt sollte dann übersprungen werden:

5. VM ID auswählen: Als letzten Schritt vor der eigentlichen Durchführung der Installation der VM wird noch nach der zu vergebenden VM ID innerhalb des Proxmox VE Systems gefragt. Hierbei wird standardmäßig die nächste freie VMID voreingetragen:

6. Installationsausgaben: Wurde der letzte Schritt bestätigt beginnt der Installationsskript automatisch mit dem Download der ausgewählten Version und installiert diese automatisch im ausgewählten Storage und verbindet auch gleich das USB Modul mit der VM:

Nun sollte die Grundinstallation der RaspberryMatic VM unter Proxmox VE abgeschlossen sein und diese in der Weboberfläche von Proxmox VE entsprechend auftauchen. Da alle Grundeinstellungen bereits vorgenommen wurden, kann die VM nun unmittelbar gestartet werden und der Startvorgang sollte daraufhin dann auch unter "Console" einsehbar sein. Für Detailinformationen des Startvorganges kann man in der Console dann die Tastenkombination ALT+F2 drücken um Ausgaben des Vorganges dort ggf. einzusehen.

Hat man im oberen allgemeinen Teil unter Schritt 3 als Virtualisierungstyp Lightweight LXC Container bzw. "CT" / "LXC" gewählt, so sollte man die folgenden Schritte des Installationsskriptes nacheinander durchgehen:

1. Warnhinweis bestätigen: Da bei einer CT/LXC-basierten Installation es notwendig ist auf dem jeweiligen Proxmox VE System selbst gewisse Zusatzpakete und Modifikationen vorzunehmen muss als erstes ein entsprechender Warnhinweis bestätigt werden: ⚠️ Hinweis: Bitte hierbei beachten, dass man die Installation dieser für CT/LXC notwendigen Zusatzpakete und Modifikationen jederzeit wieder zurücknehmen kann indem man wie in Abschnitt Deinstallation CT / LXC das install-proxmox.sh skript mit einer zusätzlichen uninstall Option aufrufen kann.

2. Funkmodul Overlays Installation: Setzt man als Proxmox VE Host ein ARM-basiertes System ein das über einen GPIO Bus verfügt (z.B. RaspberryPi, etc.) auf dem man ein RPI-RF-MOD oder HM-MOD-RPI-PCB direkt betreiben kann, so wird als nächstes abgefragt, ob man die notwendigen "device tree overlays" hierfür installieren lassen möchte: ⚠️ Hinweis: Wie erwähnt ist dieser Schritt nur notwendig wenn man vor hat eines der beiden GPIO basierten Funkmodule (RPI-RF-MOD, HM-MOD-RPI-PCB) direkt auf dem GPIO Bus seine ARM-basierten Systemes zu betreiben. Setzt man hingegen auf eine USB-basierte Anbindung (HmIP-RFUSB, HB-RF-USB-2, etc.) oder Ethernet-basierte (HB-RF-ETH, etc.) so ist dieser Schritt nicht notwendig und man sollte hier "No" auswählen.

3. Version auswählen: Hat man den Warnhinweis bestätigt muss im Anschluss nach kurzer Ladezeit eine RaspberryMatic Version für die Installation des CT/LXC containers ausgewählt werden:

   ⚠️ Hinweis: Bei der Auswahl der zu installierenden RaspberryMatic Version wird zwischen release und snapshot Versionen unterschieden. Bei letzterem muss beachten werden, dass es sich hierbei um experimentelle Entwicklungssnapshots handelt die entsprechend "instabil" sein könnten. Für eine produktive RaspberryMatic Umgebung sollte man daher bevorzugt auf die release Versionen setzen.

4. Storage auswählen: Hat man die zu installierende Version ausgewählt, wird man im nächsten Schritt dazu aufgeforderr den entsprechenden Storage auszuwählen der für den CT im späteren Verlauf verwendet werden soll (mit Taste 'Space' auswählen):

   ⚠️ Hinweis: Diese Aufforderung kommt nur wenn man mehr als ein CT Storage für Proxmox VE konfiguriert hat.

5. Userdiskgröße wählen: Nun wird man im Folgenden zur Eingabe der gewünschten virtuellen Speicherplatzgröß für die Userdisk des RaspberryMatic systems gebeten in welcher im laufenden Betrieb alle nutzerbezogenen Konfigurationsdateien und Zusatzpakete gespeichert werden:

   Als Minimum ist hier 4 GB definiert, wobei eine Größe von 6 GB auch für größere Installationen ausreichend sein sollten. Zu beachten gilt hierbei auch noch das es sich wie gesagt um virtuellen Speicherplatz handelt. D.h. selbst bei Eingabe eines größeren Wertes wird zur jeweiligen Zeit auf dem Hostsystem lediglich der aktuell verbrauchte Platz allokiert.

6. VM ID auswählen: Als letzten Schritt vor der eigentlichen Durchführung der Installation der VM wird noch nach der zu vergebenden VM ID innerhalb des Proxmox VE Systems gefragt. Hierbei wird standardmäßig die nächste freie VMID voreingetragen:

7. Installationsausgaben: Wurde der letzte Schritt bestätigt beginnt der Installationsskript automatisch mit dem Download der ausgewählten Version und installiert diese automatisch im ausgewählten Storage und richtet den CT entsprechend ein:

Nun sollte die Grundinstallation des RaspberryMatic CT unter Proxmox VE abgeschlossen sein und dieser in der Weboberfläche von Proxmox VE entsprechend auftauchen. Da alle Grundeinstellungen bereits vorgenommen wurden, kann der CT nun unmittelbar gestartet werden und der Startvorgang sollte daraufhin dann auch unter "Console" einsehbar sein und man sich da dann auch entsprechend einloggen können. Auch sollten bei eventl. Anschluss von HomeMatic Funkmodulen oder Adaptern wie HmIP-RFUSB oder HB-RF-USB-2, etc. diese sofort erkannt werden sobald diese an das Proxmox VE Hostsystem angesteckt wurden. Bei Einsatz eines RPI-RF-MOD oder HM-MOD-RPI-PCB direkt auf einem GPIO muss hierbei mitunter zuerst ein kompletter Neustart des Proxmox VE Systems samt aller VMs/CTs durchgeführt werden.

Nutzt man bereits RaspberryMatic als CT/LXC Container innerhalb von Proxmox VE, so kann man mit den folgenden Schritten recht einfach ein Update der installierten Version auf eine neue bzw. andere Version durchführen lassen:

1. CT herunterfahren: Als erstes sollte man dafür sorgen, dass der RaspberryMatic CT ordnungsgemäß heruntergefahren ist. Dies kann entweder über die Proxmox Weboberfläche passieren oder aber mittels des pct shutdown <VMID> Kommandos.

2. Backup durchführen: Um sicherzustellen, dass man bei einem eventl. Problem wieder sofort zurück zur alten Version gehen kann, sollte man über die Proxmox Weboberfläche nun am besten als erstes unter Backup -> Backup now ein frisches Backup erstellen lassen.

3. Updateskript aufrufen: Via einer geöffneten Proxmox Console kann man unter Eingabe des folgenden Kommandos den install-proxmox.sh Skript mit dem entsprechenden update Parameter aufrufen:

   wget -qO - https://raspberrymatic.de/install-proxmox.sh | bash -s update

   bzw. wenn man als nicht-root user mit sudo-rechten via SSH verbunden ist, dann via

   sudo sh -c "wget -qO - https://raspberrymatic.de/install-proxmox.sh | bash -s update"

   

4. Container auswählen: Nachdem nach kurzer Ladezeit der Skript mit der update option gestartet wurde sollten in einer Auflistung alle RaspberryMatic container aufgelistet werden und man dazu aufgerufen werden den Container für das Update auszuwählen:

5. Zielversion auswählen: Hat man den Container ausgewählt werde nach kurzer Prüfung eine Auflistung der auswählbaren Zielversionen präsentiert aus der man dann die Version auswählen sollte auf die man sein RaspberryMatic Container gerne updaten würde:

   ⚠️ Hinweis: Bei der Auswahl der zu installierenden RaspberryMatic Version wird zwischen release und snapshot Versionen unterschieden. Bei letzterem muss beachten werden, dass es sich hierbei um experimentelle Entwicklungssnapshots handelt die entsprechend "instabil" sein könnten. Für eine produktive RaspberryMatic Umgebung sollte man daher bevorzugt auf die release Versionen setzen.

6. Update bestätigen: Bevor das eigentliche Update nun durchgeführt wird, muss man als letztes noch bestätigen, dass man dieses nun durchführen lassen möchte und man vorher entsprechend ein Backup gemacht hat:

7. Update durchgeführt: Hat man das letzte Requester bestätigt, findet der eigentliche Updateprozess statt, über dessen Verlauf und Erfolg man dann in der Proxmox Console entsprechend informiert wird:

Ist das Updateskript ohne Fehler durchgelaufen kann man nun entweder via Proxmox Weboberfläche den Container wieder starten oder aber dies via pct start <VMID> erledigen und sich dann die Console wärhend des Hochfahrens des Containers z.B. via pct console <VMID> direkt anschauen um eventl. Fehler beim Hochfahren auszuschließen.

Da bei der Installation eines LXC-basierten RaspberryMatic containers auf dem jeweiligen Proxmox VE System gewisse Zusatzpakete und Modifikationen vorgenommen werden, damit der LXC Container in der Lage ist auf die an das Proxmox System angeschlossene Homematic Funkhardware (RPI-RF-MOD, etc.) zuzugreifen, kann man mit dem folgenden Befehl in einer Proxmox Console – falls man von einer LXC-basierten Installation später wieder Abstand nehmen will – die Installation dieser Zusatzpakete und Modifikationen rückgängig machen:

1. Deinstallation aufrufen: Mit dem folgenden Befehl kann man in einer Proxmox Console dafür sorgen das die Anpassungen entsprechend zurückgenommen werden:

   wget -qO - https://raspberrymatic.de/install-proxmox.sh | bash -s uninstall

   bzw. wenn man als nicht-root user mit sudo-rechten via SSH verbunden ist, dann via

   sudo sh -c "wget -qO - https://raspberrymatic.de/install-proxmox.sh | bash -s uninstall"

2. Deinstallation bestätigen: Nach dem oben gezeigten Aufruf des Installationsskriptes mit uninstall Option wird dieser als erstes um die Bestätigung des Uninstallprozesses bitten:
3. Deinstallation durchführen: Hat man den Wunsch der Deinstallation bestätigt, so werden in einem nächsten Schritt alles Zusatzpakete und Modifikationen die für die Betrieb eines RaspberryMatic CT/LXC containers notwendig sind auf dem Proxmox VE System zurückgenommen: ⚠️ Hinweis: Sollte während des Uninstall es zu Fehlermeldungen kommen kann man den Skript getrost mehrere male hintereinander Aufrufen, da dieser vor einem gewissen uninstall Schritt immer überprüft ob die Komponente noch existiert oder nicht.

Sind alle Deinstallationsschritte durchgelaufen, so sollte man einen Neustart des Proxmox VE Host systems einplanen damit dieses im Anschluss auch entsprechend ohne die momentan ggf. noch im Arbeitsspeicher befindlichen Zusatzpakete weiterarbeiten kann. Zusätzlich kann es auch noch von Vorteil sein vor dem Neustart dafür zu sorgen, dass etwaige andere Abhängigkeiten die nicht mehr verwendet werden via apt autoremove entfernt werden.

Möchte man die Installation der RaspberryMatic VM unter einer x86-basierten Proxmox VE Umgebung manuell vornehmen oder funktioniert die automatische Installation auf Grund von Firewall-Restriktionen innerhalb des lokalen Netzwerkes nicht, kann man diese auch wie folgt durchführen:

1. Download: Für Proxmox VE sollte man die *.ova Datei zur Installation nutzen. Diese kann man von Releases direkt als *.ova Datei herunterladen. Bitte hierbei beachten, das die *.zip Datei nur für spätere WebUI-basierte Updates der virtuellen Maschine benötigt wird. D.h. für die Grundinstallation braucht man für Proxmox lediglich einmalig die *.ova Datei.

2. .ova Datei in Proxmox Konsole kopieren: Die *.ova Datei muss nun mittels SCP bzw. FTP in die Proxmox Konsole kopiert werden damit von dort aus im folgenden dann die *.ova Datei entsprechend importiert werden kann:

3. Proxmox Shell starten: Nach einloggen in der Proxmox Weboberfläche kann man via Rechtsklick auf "pve" dann die "Shell" aufrufen um in die Kommandozeile von Proxmox zu gelangen:

4. .ova auspacken: Da Proxmox nicht direkt *.ova Dateien verarbeiten kann muss man diese nun via the folgenden "tar" Befehls erst einmal auspacken:

   

5. .ovf Datei importieren: Mit dem folgenden importovf Befehl kann man dann die *.ovf und die passende *.vmdk Datei automatisch als virtuelle Maschine importieren lassen (zu beachten gilt hierbei das man eine freie ID für die neue VM verwendet, d.h. in die Maschinenliste schauen und hier eine freie ID statt der "100" wählen):

6. Startvolume/disk vergrößern: Danach sollte dann die neue RaspberryMatic VM im Proxmox Webinterface aufgetaucht sein und man kann nun in die "Hardware" Einstellungen auf das angelegte "Laufwerk" klicken und dort dann "Resize Disk" zum vergrößern der Festplatte drücken und dann im folgenden Dialog die gewünschte Größe der Festplatte eingeben:

7. USB-Gerät hinzufügen: Um nun das USB Funkmodul hinzuzufügen geht man wiederum unter "Hardware" auf "Hinzufügen" und fügt dort das gewünschte USB Gerät hinzu das am Proxmox Host dann entsprechend verbunden sein muss:

8. Netzwerkkarte hinzufügen: Nun muss noch eine kompatible Netzwerkkarte wie folgt hinzugefügt werden. Hierbei beachten als Netzwerkkartenmodell "VirtIO" auszuwählen:

9. Einstellungen kontrollieren: Danach sollten dann die VM-Einstellungen wie folgt aussehen. Wichtig sind hierbei die Kontrolle der Einstellungen unter "Hardware". So sollten z.B. der ausgewählte SCSI Controller auf VirtIO SCSI single stehen und Zusatzoptionen der virtuellen Disk wie iothread=1 oder discard=on (bei einer genutzten SSD) eingeschalten sein: Des Weiteren ist auch wichtig unter "Optionen" z.B. den eingestellten "OS Type" zu kontrollieren und hier sicherzustellen das dort Linux 6.x - 2.6 Kernel ausgewählt ist und auch die Option "Use tablet for pointer" auf No steht:

10. Guest Agent aktivieren: Damit der in RaspberryMatic installierte Guest Agent korrekt erkannt wird sollte unter "Optionen" noch der "Qemu Agent" wie folgt aktiviert werden:

11. Das erste mal starten: Nach diesen Aktionen sollte es nun möglich sein die virtuelle RaspberryMatic das erste mal zu starten um dann in der virtuellen Konsole/Bildschirm den normalen Bootvorgang zu sehen. Dies sollte dann hoffentlich dazu führen das sich die neue virtuelle CCU/RaspberryMatic dann mit Ihrer neuen IP-Adresse meldet und man ganz normal dann in einem Webbrowser zur WebUI der virtuellen RaspberryMatic gelangen sollte.

Möchte man ein performantes ARM-basiertes System wie ein RaspberryPi4 oder RaspberryPi5 als Virtualisierungsumgebung einsetzen um darauf mehrere virtuelle Maschinen (VM) wie z.B. eine RaspberryMatic VM und andere Linux VM parallel zu betreiben, kann man auf solchen Systemen seit einiger Zeit durch entsprechende Arbeiten der OpenSource Community auch Proxmox VE installieren. Hierfür existiert dann auch die Möglichkeit ein virtuelles RaspberryMatic System hierüber zu betreiben. Da die Installation einer solchen ARM-basierten Proxmox VE Installation jedoch vom Standardfall abweicht, soll im Folgenden als Hilfestellung eine kleine Schritt-für-Schritt Anleitung gegeben werden wie man solch eine Proxmox VE Grundinstallation auf seinem RaspberryPi4 oder RaspberryPi5 durchführen kann.

Da Proxmox VE als zugrundeliegendes Betriebssystem ein Debian-basiertes Linux System voraussetzt, muss man als erstes eine solche Debian Grundinstallation auf der ausgewählten ARM-Hardware vornehmen. Hierzu kann man für einen RaspberryPi4 oder RaspberryPi5 entweder RaspberryPiOS oder aber auch auf das potentere Armbian setzen. Im Folgenden soll daher auf die Proxmox VE Installation eines RaspberryPi5 via Armbian eingegangen werden:

1. Armbian Image runterladen: Um Armbian in der jeweilig passenden Version für seine ARM-Hardware herunterzuladen kann man das passende Grund-Image von der Armbian aarch64 Downloadseite herunterladen. Hierbei sollte man jeweils das Armbian Bookworm Image in der Minimal CLI Variante herunterladen. So z.B. für einen RaspberryPi5 scrollt man auf der Downloadseite (https://www.armbian.com/rpi5b/) ganz nach unten und lädt hierbei das "Minimal CLI" Bookworm Image herunter:
2. Armbian Image flashen: Nach dem herunterladen der passenden Armbian Image Datei (z.B. Armbian_..._minimal.img.xz) kann man diese via geeigneter Anwendungen (z.B. Etcher) auf das passende Medium (z.B. SD Karte) flashen:
3. Armbian das erste mal booten: Nun kann man das entsprechende Medium in seinen SBC einlegen und Armbian damit das erste mal booten lassen. Wichtig ist hierbei einen Monitor und Tastatur anzuschließen da im ersten Bootvorgang verschiedene Informationen abgefragt werden die man interaktiv dann eingeben muss. Dies umfasst die folgenden Informationen die man wie folgt beantworten kann:

   1. Create root password: [Hier das entsprechende Root-Password angeben]
   2. Please provide a username: admin
   3. Create user (admin) password: [Hier erneut das entsprechende Admin Password angeben]
   4. Please provide your real name: Admin
   5. Set user language based on your location? N
   6. At your location, more locales are possible: 54 (en_US.UTF-8)
   7. Please select a continent: 7 (Europe)
   8. Please select a country: 16 (Germany)
   9. Please select one of the following timezones: 2 (most of Germany)
   10. Is the above information OK? 1 (Yes)
   

   Danach sollte dann Armbian in einen Kommandozeilen Prompt wechseln. Von hier aus kann man dann entsprechend weiterarbeiten oder aber auch via SSH Zugang zu der IP-Adresse des Systems (Ausgabe von ip a zeigt die IP-Adresse) die weiteren Einstellungen vornehmen.
4. Hostname ändern: Nun sollte man den Namen des Hosts entsprechend auf den finalen Hostnamen ändern:

   sudo hostnamectl hostname pvearm

5. /etc/network/interfaces anpassen: Um eine statische IP-Adresse für die kommende Proxmox Installation vorzunehmen sollte man die /etc/network/interfaces um folgende Einträge hin erweitern,

   sudo nano /etc/network/interfaces

   d.h. diese Einträge ändern oder hinzufügen:

   auto lo
   iface lo inet loopback
   
   iface end0 inet manual
   
   auto vmbr0
   iface vmbr0 inet static
       address 192.168.1.2/24
       gateway 192.168.1.1
       bridge-ports end0
       bridge-stp off
       bridge-fd 0
   

   ⚠️ Hinweis: Hinter address sollte man hierbei die ausgewählte statische IPv4 Adresse angeben sowie hinter gateway die IPv4 Adresse des Routers/Gateways. Auch sollte man beachten, dass ggf. das Hauptinterface nicht end0 heisst, sondern eth0 oder ähnlich. Hierzu kann man ggf. sich die aktuellen Netzwerksettings via ip a Befehl auflisten lassen.
6. /etc/hosts anpassen: Nach der Änderung des hostname und der Netzwerkeinstellungen sollte man nun in der /etc/hosts mit einem geeigneten Editor

   sudo nano /etc/hosts

   die Zeile mit dem 127.0.1.1 Eintrag löschen und entsprechend die Datei auf folgendes Muster hin ändern:

   127.0.0.1   localhost
   192.168.1.2 pvearm pvearm.fritz.box
   ::1         localhost ip6-localhost ip6-loopback
   fe00::0     ip6-localnet
   ff00::0     ip6-mcastprefix
   ff02::1     ip6-allnodes
   ff02::2     ip6-allrouters
   

   D.h. einen Eintrag mit der geplanten festen IP-Adresse (hier als Beispiel 192.168.1.2) des Hosts anstelle des 127.0.1.1 Eintrages samt neuem hostname und FQDN dort einzutragen.
7. APT update durchführen: Nun sollte man via des folgenden Befehles ein generelles System update durchführen lassen und dann das System auch automatisch neustarten:

   sudo apt update && sudo apt full-upgrade && sudo apt install unzip && sudo reboot

8. Proxmox-ARM APT repository hinzufügen: Ist das System wieder korrekt hochgefahren und auch via der vergebenen statischen IP-Adresse wieder erreichbar sollte man via folgenden Kommandos dafür sorgen, dass die entsprechenden APT Repositories für die Proxmox VE ARM Installation zur Verfügung stehen:

   sudo sh -c "echo 'deb https://mirrors.apqa.cn/proxmox/debian/pve bookworm port' >/etc/apt/sources.list.d/pveport.list"
   sudo sh -c "curl https://mirrors.apqa.cn/proxmox/debian/pveport.gpg -o /etc/apt/trusted.gpg.d/pveport.gpg"
   sudo apt update && sudo apt full-upgrade

9. ifupdown2 Paket installieren: Damit die vorgenommenen Netzwerkeinstellungen (z.B. statische IP-Adresse) aktiv werden können sollte mit folgendem Befehl als erstes das ifupdown2 Paket installiert werden:

   sudo apt install ifupdown2 && sudo reboot

   ⚠️ Hinweis: Sollte bei der Installation des ifupdown2 Paketes ein Fehler auftreten muss man erst einen reboot (sudo reboot) durchführen und dann die Installation des Paketes erneut durchführen inkl. eines weitere Reboots.
10. Proxmox VE Pakete installieren: Nachdem das System neugestartet hat und wieder via Netzwerk erreichbar ist kann mit folgendem Befehl nun die eigentlichen Proxmox VE Pakete installieren lassen:

    sudo apt install proxmox-ve postfix open-iscsi

    Im Laufe der Installation wird nach einigen Konfigurationsparametern des postfix Paketes gefragt. Hierbei sollte man diese dann wie folgt beantworten:

    1. General mail configuration type: Satellite system
    2. SMTP relay host: [IP-Adresse des lokalen SMTP servers]
    

    oder die Option local auswählen.
11. /boot/firmware/cmdline.txt anpassen: Damit auch LXC/CT Container korrekt in der ARM-basierten Proxmox VE Installation funktionieren sollte man noch (bei einem RaspberryPi) in der /boot/firmware/cmdline.txt

    sudo nano /boot/firmware/cmdline.txt

    folgende Kernel optionen am Ende hinzufügen:

    cgroup_enable=cpuset cgroup_enable=memory cgroup_memory=1
    

    ⚠️ Hinweis: Wenn man als ARM System kein RaspberryPi einsetzen sollte, so sollte man dort auch sicherstellen, dass die oben genannten kernel parameter dem jeweiligen Bootloader mitgegeben werden.
12. Finaler Neustart: Wurden im vorherigen Schritt alle Pakete korrekt installiert kann man mit folgendem Befehl einen finalen Neustart durchführen lassen:

    sudo reboot

13. Auf Proxmox WebUI zugreifen: Nach dem finalen Neustart kann man dann via https://<IP-ADRESSE>:8006/ auf die Proxmox Weboberfläche zugreifen: Ist dieser letzte Schritt abgeschlossen, kann man sich dann danach der Installation der RaspberryMatic VM annehmen.