Überblick
Proxmox-Vorlagen müssen in Hostware registriert werden, bevor Du sie als Produktoptionen anbieten kannst. Eine Vorlage, die in Proxmox existiert, ist in Hostware nicht automatisch verfügbar — Du musst sie für jeden Proxmox-Node separat registrieren.
In diesem Artikel erfährst Du, wie Du KVM- und LXC-Vorlagen registrierst und wie Du ihre IDs in der Produktkonfiguration verwendest.
Vor dem Start
Stelle sicher, dass Du Folgendes hast:
Mindestens einen in Hostware konfigurierten Proxmox-Host
Vorlagen, die bereits hochgeladen sind oder in Deinem Proxmox-Speicher verfügbar sind
Vorlagen in Hostware registrieren
Die Vorlagenseite öffnen
Gehe in der Hostware-Seitenleiste zu Hosting → Proxmox → Templates.
Die Vorlage zu Proxmox (PVE) hinzufügen
Lade Deine Vorlage direkt in Proxmox hoch oder installiere sie dort, bevor Du sie in Hostware registrierst. Hostware liest Vorlagen ein, die bereits in Deinem Proxmox-Speicher vorhanden sind.
Pro Node registrieren
Vorlagen müssen für jeden Proxmox-Node registriert werden, auf dem sie verfügbar sein sollen. Hostware kann eine Vorlage nur dann für die Bereitstellung verwenden, wenn sie in Hostware ausdrücklich mit dem Node verknüpft ist.
Die Vorlagen-ID verwenden, nicht den Namen
Wenn Du Produktoptionen konfigurierst, verwende die Vorlagen-ID — nicht den VM-Namen oder den Vorlagennamen. Die Vorlagen-ID ist der Bezeichner, den Hostware verwendet, um bei der Bereitstellung auf die Vorlage zu verweisen.
KVM-Vorlagen
Bei KVMs (virtuellen Maschinen) entspricht die Vorlagen-ID in der Regel der VM-ID in Proxmox. Wenn Du eine VM in eine Vorlage umwandelst, behält Proxmox die ursprüngliche VM-ID als Vorlagenkennung bei.
In Proxmox suchst Du die Vorlage und notierst Dir ihre VM-ID (z. B. 100, 200)
In Hostware registrierst Du diese ID unter Hosting → Proxmox → Templates
Wenn Du Produktoptionen erstellst, gibst Du die Vorlagen-ID (z. B. 100) im Vorlagenfeld ein
LXC-Vorlagen
Bei LXC-Containern ist die Vorlagen-ID der Vorlagen-Dateiname, so wie er im Proxmox-Speicher angezeigt wird.
Gehe in Proxmox zum lokalen Speicher des Nodes
Klicke auf CT Templates, um verfügbare LXC-Vorlagen anzuzeigen
Notiere Dir den exakten Vorlagendateinamen (z. B. ubuntu-22.04-standard_22.04-1_amd64.tar.zst)
In Hostware registrierst Du diesen Dateinamen als Vorlagen-ID
Wenn Du Produktoptionen erstellst, gibst Du den vollständigen Vorlagendateinamen im Vorlagenfeld ein
Um den Dateinamen einer LXC-Vorlage in Proxmox zu kopieren: Wähle die Vorlage aus, klicke auf Remove, und kopiere den Vorlagennamen aus dem Bestätigungs-Popup. Breche das Entfernen danach ab. So erhältst Du den exakten Dateinamen, den Du für Hostware benötigst.
Fehlerbehebung
Das ist das häufigste Problem und bedeutet normalerweise, dass die Vorlage in Hostware nicht für den richtigen Node registriert ist.
Lösung:
Prüfe, ob die Vorlage in Proxmox auf dem Ziel-Node vorhanden ist
Gehe in Hostware zu Hosting → Proxmox → Templates
Stelle sicher, dass die Vorlage unter demselben Node registriert ist, der die VM bzw. den Container bereitstellt
Stelle sicher, dass die Vorlagen-ID in der Produktoption exakt übereinstimmt — verwende die ID, nicht den Vorlagennamen
Hostware kann Vorlagen nicht sehen, nur weil sie in Proxmox existieren. Die Registrierung erfolgt ausdrücklich und node-spezifisch.
Prüfe, dass Folgendes zutrifft:
Die Vorlage ist in Hostware für den richtigen Proxmox-Node registriert
Du verwendest das Vorlagen-ID-Format, das Hostware erwartet (VM-ID für KVM, Dateiname für LXC)
Die Hostgruppe hat die richtigen Speicherorte konfiguriert
Nächste Schritte
