Instalación

Migrar desde Immich

¿Ya usas Immich? La migración es sencilla — reemplaza dos nombres de imagen en tu docker-compose.yml y actualiza IMMICH_VERSION en tu .env. La versión actual es v4.

image: ghcr.io/open-noodle/gallery-server:${IMMICH_VERSION:-release}
image: ghcr.io/open-noodle/gallery-ml:${IMMICH_VERSION:-release}

Después descarga las nuevas imágenes y reinicia:

docker compose pull && docker compose up -d

Tus datos, base de datos y configuración son totalmente compatibles — no se necesita ningún paso de migración.

¿Tienes curiosidad por lo que Gallery aporta a Immich? Lee la comparativa completa Gallery vs. Immich →

Requisitos

Descargar los archivos de configuración

Crea un directorio para Noodle Gallery y descarga el archivo de Docker Compose junto con la plantilla de entorno.

mkdir ./noodle-gallery
cd ./noodle-gallery

wget -O docker-compose.yml https://github.com/open-noodle/gallery/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/open-noodle/gallery/releases/latest/download/example.env

Configurar el entorno

Abre el archivo .env y ajusta tus parámetros. Las opciones principales están arriba — el almacenamiento S3 es opcional.

# ── Parámetros básicos ─────────────────────────────────────────

# Ubicación de almacenamiento de fotos y vídeos
UPLOAD_LOCATION=./library

# Ubicación de los datos de PostgreSQL (debe ser un disco local, no una unidad de red)
DB_DATA_LOCATION=./postgres

# Zona horaria: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
TZ=Etc/UTC

# Etiqueta de la imagen del contenedor — "release" para la versión actual, "v4" para la última v4.x o fijar p. ej. "v4.0.1"
IMMICH_VERSION=release

# IMPORTANTE: Reemplázalo por una contraseña aleatoria (solo A-Za-z0-9)
DB_PASSWORD=change-me-to-something-random

# Estos valores por defecto rara vez necesitan modificarse
DB_USERNAME=postgres
DB_DATABASE_NAME=immich

# ── Almacenamiento compatible con S3 (opcional) ────────────────
# Descomenta para almacenar las subidas en S3 en lugar del disco local.
# Funciona con AWS S3, MinIO, Cloudflare R2, Backblaze B2, Wasabi, etc.

# IMMICH_STORAGE_BACKEND=s3
# IMMICH_S3_BUCKET=mi-bucket-gallery
# IMMICH_S3_REGION=eu-central-1
# IMMICH_S3_ENDPOINT=https://s3.eu-central-1.amazonaws.com
# IMMICH_S3_ACCESS_KEY_ID=
# IMMICH_S3_SECRET_ACCESS_KEY=
# IMMICH_S3_SERVE_MODE=redirect
# IMMICH_S3_PRESIGNED_URL_EXPIRY=3600

Iniciar los contenedores

Ejecuta el siguiente comando desde el directorio noodle-gallery:

docker compose up -d

Este comando descarga las imágenes de los contenedores, crea la base de datos e inicia todos los servicios. En el primer arranque se descargan unos 2 GB de imágenes, lo que puede tardar unos minutos.

Acceder a la interfaz web

Abre http://ip-de-tu-servidor:2283 en tu navegador. Se te pedirá crear la primera cuenta de administrador.

La aplicación móvil (Android & iOS) se conecta a la misma URL. Descárgala en Play Store o la App Store e introduce la URL de tu servidor.

Aceleración por GPU opcional

Para una inferencia de ML más rápida (reconocimiento facial, CLIP, detección de mascotas), usa una imagen de ML acelerada por GPU:

# En docker-compose.yml, cambia la etiqueta de la imagen de ML:
image: ghcr.io/open-noodle/gallery-ml:${IMMICH_VERSION:-release}-cuda

Etiquetas disponibles: -cuda (NVIDIA), -rocm (AMD), -openvino (Intel).

Actualizar

Actualizar a la última versión:

docker compose pull
docker compose up -d

Las migraciones de la base de datos se ejecutan automáticamente al iniciar. Haz siempre una copia de seguridad de tu base de datos antes de las actualizaciones mayores.

Documentación de la API

Gallery expone una API REST completa documentada mediante OpenAPI. Cada instancia en ejecución ofrece una interfaz Swagger interactiva en /doc — incluyendo todos los endpoints específicos del fork para los Espacios compartidos, los grupos de usuarios y la detección de mascotas.

La API también se puede consultar en la demo en vivo:

Preguntas frecuentes