Guía Completa de Despliegue LXC y Docker para Immich en Proxmox
Esta guía detalla el proceso completo para crear un contenedor LXC en Proxmox VE y desplegar Immich utilizando Docker Compose.
1. Características Recomendadas del LXC
| Parámetro | Valor Recomendado | Descripción / Notas |
|---|---|---|
| Arquitectura | LXC (Unprivileged / No privilegiado) | Recomendado por seguridad |
| Sistema Operativo | Debian 13 (Trixie) | Sistema operativo base |
| Cores CPU | 4 Cores (Mínimo 2) | Procesamiento de vídeo, miniaturas y reconocimiento facial |
| Memoria RAM | 4096 MB (4 GB) - 8192 MB (8 GB) | Requerido por los modelos de Machine Learning (CLIP) |
| Memoria SWAP | 2048 MB (2 GB) | Margen para picos durante la indexación inicial de imágenes |
| Almacenamiento (SO) | 20 GB (SSD / NVMe) | Para el sistema, Docker e imágenes de contenedores |
| Almacenamiento (Fotos) | 100 GB+ (Montaje/Volumen) | Espacio asignado para la biblioteca multimedia |
| Red (Bridge) | vmbr0 (DHCP o IP Estática) |
Configurar IP fija recomendada |
| Opciones Clave | Nesting = 1 |
Obligatorio para ejecutar Docker dentro del LXC |
| FUSE / OverlayFS | keyctl = 1 |
Necesario para la gestión de capas en Docker |
2. Creación del LXC y Preparación del Entorno
- Creación con Helper-Scripts: Puedes desplegar el LXC base ejecutando el script interactivo oficial: 👉 Proxmox VE Helper-Scripts - Debian LXC
- Instalación de Docker Engine: Una vez creado el LXC y dentro de su terminal, instala Docker siguiendo la guía: 👉 Tutorial de Instalación de Docker en Debian
3. Montar NFS de los datos en el contenedor
Entraremos al contenedor y crearemos las siguientes carpetas.
Luego siguiendo esta guía, mapearemos las carpetas montadas en el host de proxmox a las del contenedor.
4. Despliegue de Immich con Docker Compose
Crea el directorio de trabajo para Immich.
Descargar fichero docker-compose.
wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
Descargar en fichero de configuración de variables.
Abrimos el fichero .env y cambiamos el directorio de datos.
Para levantar el contenedor e iniciar el servicio:
Acceso web: http://<IP_DE_TU_LXC>:2283