Proxmox VPS

VM-/OS-Vorlagen verwalten

Ü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

  1. Die Vorlagenseite öffnen

    Gehe in der Hostware-Seitenleiste zu Hosting → Proxmox → Templates.

  2. 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.

  3. 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.

  4. 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.

  1. In Proxmox suchst Du die Vorlage und notierst Dir ihre VM-ID (z. B. 100, 200)

  2. In Hostware registrierst Du diese ID unter Hosting → Proxmox → Templates

  3. 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.

  1. Gehe in Proxmox zum lokalen Speicher des Nodes

  2. Klicke auf CT Templates, um verfügbare LXC-Vorlagen anzuzeigen

  3. Notiere Dir den exakten Vorlagendateinamen (z. B. ubuntu-22.04-standard_22.04-1_amd64.tar.zst)

  4. In Hostware registrierst Du diesen Dateinamen als Vorlagen-ID

  5. 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

Vorlage funktioniert in Proxmox manuell, aber die Bereitstellung über Hostware schlägt fehl

Das ist das häufigste Problem und bedeutet normalerweise, dass die Vorlage in Hostware nicht für den richtigen Node registriert ist.

Lösung:

  1. Prüfe, ob die Vorlage in Proxmox auf dem Ziel-Node vorhanden ist

  2. Gehe in Hostware zu Hosting → Proxmox → Templates

  3. Stelle sicher, dass die Vorlage unter demselben Node registriert ist, der die VM bzw. den Container bereitstellt

  4. 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.

Produktoption zeigt falsche oder keine Vorlagen an

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

War das hilfreich?