pveam

Update container template database

$ pveam [[u|update]]

$ pveam [[a|available]]

$ pveam [[d|download]] [local] [template_name]

$ pveam [[l|list]] [local]

$ pveam [[a|available]] --section [system|turnkeylinux|mail]

$ pveam [[r|remove]] [local]:[vztmpl]/[template_name]

pveam command [options]

Examples:
pveam update
pveam list
pveam download local debian-11-standard_11.0-1_amd64.tar.gz
pveam delete local ubuntu-22.04-standard_22.04-1_amd64.tar.gz

download
    Downloads a container template or ISO image to the specified storage.
storage: The ID of the storage where the file will be saved.
template-id|URL: The ID of the template from the Proxmox template catalog (e.g., 'ubuntu-20.04-standard') or a direct URL to the template/ISO file.

list [options]
    Lists existing container templates and ISO images stored on the Proxmox VE server.
Common options include:
-p, --pve-only: Show only official Proxmox VE templates.
-template, --template-only: Show only container templates.
-iso, --iso-only: Show only ISO images.

delete
    Deletes a specific container template or ISO image from the designated storage.
storage: The ID of the storage from which to delete.
filename: The full name of the file to delete (e.g., 'ubuntu-20.04-standard_20.04-1_amd64.tar.gz').

update
    Updates the local index of available container templates from the official Proxmox VE repositories. This command fetches the latest list of templates and their download URLs.

pveam is the Proxmox Virtual Environment Appliance Manager, a powerful command-line utility for managing container templates and ISO images within a Proxmox VE cluster. It streamlines the deployment process by allowing users to easily download official Proxmox templates for LXC containers and ISO files for virtual machines directly from configured repositories or custom URLs.

With pveam, administrators can quickly list, download, and delete these essential files, ensuring that up-to-date resources are readily available for creating new virtual machines and containers. It's an indispensable tool for efficient resource provisioning and management in a Proxmox VE environment.

Running pveam typically requires root privileges or sudo due to its system-wide management of templates and ISOs.
For download and update commands, an active internet connection is essential to access Proxmox VE repositories.
Ensure the target storage is correctly configured and has sufficient free space before attempting downloads.

A common workflow involves first running pveam update to refresh the template catalog. Next, pveam list can be used to view available templates and their IDs. Finally, pveam download fetches the desired template. Once downloaded, these templates can be used to create new containers via pct create or VMs via qm create.

Container templates are typically distributed as compressed archives (e.g., *.tar.gz), designed for use with LXC containers. ISO images are standard optical disc images (*.iso) used for installing operating systems on KVM virtual machines.

The pveam command is an integral part of the Proxmox Virtual Environment, a comprehensive open-source virtualization platform developed by Proxmox Server Solutions GmbH. It was introduced as a core utility to simplify and standardize the management of container templates and ISO images, reflecting Proxmox VE's focus on ease of use and rapid deployment for both KVM virtual machines and LXC containers since its early versions.

pct(1), qm(1), pvesm(1)