Proxmox VPS

Manage VM/OS templates

Overview

Proxmox templates must be registered in Hostware before you can offer them as product options. A template that exists in Proxmox is not automatically available to Hostware — you need to register it explicitly under each Proxmox node.

This article covers how to register KVM and LXC templates and how to use their IDs in product configuration.

Before you start

Ensure you have:

Register templates in Hostware

  1. Open the templates page

    Go to Hosting → Proxmox → Templates in the Hostware sidebar.

  2. Add the template to Proxmox (PVE)

    Upload or install your template directly in Proxmox before registering it in Hostware. Hostware reads templates that already exist in your Proxmox storage.

  3. Register per node

    Templates must be registered for each Proxmox node where they should be available. Hostware cannot use a template for provisioning unless it is explicitly linked to the node in Hostware.

  4. Use the template ID, not the name

    When configuring product options, use the template ID — not the VM name or template name. The template ID is the identifier Hostware uses to reference the template during provisioning.

KVM templates

For KVM (virtual machines), the template ID typically corresponds to the VM ID in Proxmox. When you convert a VM to a template, Proxmox retains the original VM ID as the template identifier.

  1. In Proxmox, locate the template and note its VM ID (e.g., 100, 200)

  2. In Hostware, register this ID under Hosting → Proxmox → Templates

  3. When creating product options, enter the template ID (e.g., 100) in the template field

LXC templates

For LXC (containers), the template ID is the template file name as it appears in Proxmox storage.

  1. In Proxmox, go to the node's local storage

  2. Click CT Templates to view available LXC templates

  3. Note the exact template filename (e.g., ubuntu-22.04-standard_22.04-1_amd64.tar.zst)

  4. In Hostware, register this filename as the template ID

  5. When creating product options, enter the full template filename in the template field

To copy an LXC template filename in Proxmox: select the template, click Remove, and copy the template name from the confirmation popup. Cancel the removal afterwards. This gives you the exact filename needed for Hostware.

Troubleshooting

Template works manually in Proxmox but Hostware provisioning fails

This is the most common issue and usually means the template is not registered for the correct node in Hostware.

Solution:

  1. Verify the template exists in Proxmox on the target node

  2. In Hostware, go to Hosting → Proxmox → Templates

  3. Ensure the template is registered under the same node that will provision the VM/container

  4. Confirm the template ID in the product option matches exactly — use the ID, not the template name

Hostware cannot see templates just because they exist in Proxmox. Registration is explicit and node-specific.

Product option shows wrong or no templates

Check that:

  • The template is registered for the correct Proxmox node in Hostware

  • You are using the template ID format Hostware expects (VM ID for KVM, filename for LXC)

  • The host group has the correct storage locations configured

Next steps

Was this helpful?