Immich — Deployment Template

Immich App Template
This App Template deploys a fully configured Immich instance inside an LXC container managed by the PUQcloud Proxmox Module.
The application runs in full isolation using Docker, ensuring security, separation, and reliable performance for each user.

Each deployment is unique: PUQcloud automatically sets environment variables, creates storage directories, configures permissions, and deploys a fully functional Immich setup without any manual steps.

Key Features

  • Runs inside an isolated LXC container (Proxmox)
  • Full Docker-based Immich installation (server + machine learning + Redis + PostgreSQL)
  • Automatic database and Redis configuration
  • User-specific data directories (library, cache, postgres)
  • Automatic reverse-proxy configuration (Nginx)
  • Built-in health check and startup validation
  • No manual configuration needed

Dynamic Environment Variables

  • DATA_PATH – storage for Immich library, cache, and database
  • DB_HOSTNAME, DB_USERNAME, DB_PASSWORD, DB_DATABASE_NAME – PostgreSQL credentials
  • REDIS_HOSTNAME – Redis server
  • IMMICH_MACHINE_LEARNING_URL – machine learning service URL

How it works

  1. PUQcloud Panel creates an LXC container via the Proxmox Module
  2. The template applies all required environment variables
  3. Storage paths are mounted into the container
  4. Docker Compose automatically deploys Immich server, ML service, Redis, and PostgreSQL
  5. Nginx reverse proxy is configured with the correct domain and port
  6. The Immich instance is ready to use

This template allows any user to deploy Immich in minutes — secure, isolated, and fully managed by PUQcloud.

Immich-docker-3d1a6c7c-3659-466a-bf1a-e54004af13d6.json (9.3 KB)