Skip to content

mhzawadi/proxmox-lxc-templates

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

201 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Proxmox LXC Templates

Custom LXC container templates for Proxmox VE. Pre-configured, optimized, and ready to deploy.

Build License

Overview

This project provides production-ready LXC container templates built with GitHub Actions using debootstrap. All templates are based on Debian 13 (Trixie) and include:

  • SHA-512 verified downloads
  • Built-in update mechanism with rollback support
  • Consistent UID/GID mapping for shared storage
  • Minimal footprint with only required packages

Website: https://mhzawadi.github.io/proxmox-lxc-templates/

Available Templates

Template Description Version
Jellyfin Media Server 10.11.6
Nextcloud cloud storage 32.0.6
Nginx Web Server 1.28.2
Vaultwarden Unofficial Bitwarden 1.35.4

Installation

Web UI

  1. Navigate to Datacenter > Storage > local > CT Templates
  2. Click Download from URL
  3. Copy the URL and SHA-512 checksum from the website
  4. Paste both values and click Query URL then Download

CLI

pvesh create /nodes/$(hostname)/storage/local/download-url \
  --content vztmpl \
  --filename <FILENAME> \
  --url <URL> \
  --checksum <SHA512> \
  --checksum-algorithm sha512

Get the complete command with all values from the website.

Update Containers

Every template includes template-update for in-place updates:

template-update status      # Check current version and available updates
template-update update      # Download and apply update
template-update rollback    # Restore previous version from backup
template-update changelog   # View changelog
template-update history     # Show update history

Shared Storage

Templates use consistent UID/GID mapping for shared storage access:

Category GID Description
media 1100 Jellyfin, Shoko, JDownloader
network 1200 Nginx, Nginx Proxy Manager
storage 1600 ecoDMS

Mount shared storage with matching group ownership to enable access across containers.

Contributing

  1. Fork the repository
  2. Create a template directory: templates/<name>/debian-13/
  3. Add required files: config.yml, build.sh, update.sh, CHANGELOG.md
  4. Submit a pull request

See existing templates for reference.

License

MIT

About

Self-updating LXC template repository for Proxmox VE with native UI integration

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors