
Using External LXC Templates in Proxmox
- 3 minsUsing External LXC Templates in Proxmox
Learn how to create Linux Containers (LXC) in Proxmox VE using alternative image repositories outside the default Proxmox options.
Standard Method: Proxmox Templates
By default, Proxmox allows you to create containers using official templates. The process goes like this:
Step 1: Refresh Template List
pveam update
This command syncs your template list with the Proxmox servers.
Step 2: Pick Your Storage
Navigate to your preferred storage volume (e.g. local
, local-lvm
, etc.), then go to:
CT Templates > Templates
Step 3: Download a Template
Browse the available images (Debian, Ubuntu, TurnKey, etc.) and download the one you need. This template becomes available when creating a new container.
Why Use External Template Sources?
Although Proxmox provides a rich selection, it doesn’t cover everything. Some distributions like Linux Mint, Arch Linux, or Fedora might not be listed.
You can grab additional LXC templates from other sources:
These mirrors host many more distributions and variations.
Example: Using a Linux Mint Image
Let’s walk through using a Linux Mint container image hosted externally.
Step 1: Navigate the Repository
Visit the repo:
https://images.linuxcontainers.org/images/
Then choose:
Mint > [VERSION] > amd64 > default > [DATE]
Look for the file named:
rootfs.tar.xz
“default” images are for general-purpose containers. “cloud” images include cloud-init tools.
Download the Template to Proxmox
- Copy the link to the
rootfs.tar.xz
file. https://images.linuxcontainers.org/images/mint/wilma/amd64/default/20250521_08%3A51/rootfs.tar.xz -
In the Proxmox web UI, go to:
CT Templates > Download from URL
- Paste the copied link into the URL field.
- Hit Query URL – it will fetch the metadata.
- Add a description so you remember what the image is for.
- Click Download.
Once finished, you’ll see TASK OK.
Create a New Container
- Go to Create CT in the Proxmox dashboard.
- Under Template, select the external image you just downloaded.
- Configure your container as usual (hostname, disk, CPU, etc.)
- Launch the container.
- Login as
root
with the password or SSH key provided during setup.
Managed vs. Unmanaged Containers
Proxmox includes optimizations for official containers – such as OS detection and startup tweaks. These don’t always apply to external templates.
To avoid conflicts:
-
Edit your container config at:
/etc/pve/lxc/<CT-ID>.conf
-
Add or change:
ostype: unmanaged
This tells Proxmox not to try and auto-adjust the OS internals.
Summary
Using external templates in Proxmox unlocks a broader ecosystem of Linux distributions. Whether you’re looking for more flexibility, specific versions, or niche distros – this method gives you that power.
References:
Thanks for reading!
—
Guneycan Sanli