Skip to content

Instantly share code, notes, and snippets.

@ngoc-minh-do
Created August 10, 2025 14:28
Show Gist options
  • Select an option

  • Save ngoc-minh-do/aa879ce68b2f7abc909aed8fe68f220e to your computer and use it in GitHub Desktop.

Select an option

Save ngoc-minh-do/aa879ce68b2f7abc909aed8fe68f220e to your computer and use it in GitHub Desktop.

Proxmox LXC

Downloading Templates

Option 1 – Web UI (Easiest)

  1. Open Proxmox Web InterfaceStorage (e.g., local, local-lvm).
  2. Select CT Templates.
  3. Click Templates (top-right).
  4. Choose a template (Debian, Ubuntu, Alpine, etc.) → Download.

Option 2 – CLI (Good for scripting/remote)

  1. SSH into your Proxmox host.
  2. List available templates:
    pveam available
    Example output:
    system          alpine-3.19-default_20240101_amd64.tar.xz
    system          debian-12-standard_20240701_amd64.tar.zst
    
  3. Download a template to local storage:
    pveam download local debian-12-standard_20240701_amd64.tar.zst
    • Replace local with your storage name.
    • Replace the filename with one from the list.

Option 3 – From linuxcontainers.org (Upstream images)

  1. Find an image
    Visit: https://images.linuxcontainers.org
    Example path:

    images/debian/bookworm/amd64/default/
    

    Files include:

    rootfs.tar.xz
    metadata.yaml
    
  2. Download rootfs archive to Proxmox template storage:

    wget https://images.linuxcontainers.org/images/debian/bookworm/amd64/default/20240810_05:24/rootfs.tar.xz         -O /var/lib/vz/template/cache/debian-12-bookworm-lxc.tar.xz
    • /var/lib/vz/template/cache is the default local storage template folder.
    • Rename the file as needed.
  3. Create the container
    In the Proxmox Web UI, the .tar.xz will appear in the Template dropdown when creating a new container.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment