¿Quieres una alternativa a Google Fotos que guarde fotos y vídeos en tu propio equipo? Esta guía muestra cómo instalar Immich en Windows 11 con WSL2 y Docker Desktop. Utiliza los archivos oficiales de Docker Compose y el puerto actual 2283. También explica el detalle más importante en Windows: dónde guardar la base de datos PostgreSQL.
Antes de empezar: Immich recomienda Linux o un sistema similar de 64 bits. Windows es una opción posible para aprender o probar, pero no es el entorno de servidor preferido por el proyecto. Prepara una copia de tus fotos antes de cambiar su ubicación.
- Qué es Immich y cómo funcionará en Windows
- Requisitos antes de instalar
- Paso 1: activar WSL2
- Paso 2: instalar Docker Desktop
- Paso 3: crear un directorio de trabajo en WSL2
- Paso 4: descargar los archivos oficiales de Compose
- Paso 5: revisar .env
- Paso 6: proteger la ubicación de PostgreSQL
- Paso 7: iniciar Immich
- Paso 8: abrir Immich en el navegador
- Paso 9: crear la cuenta de administrador
- Paso 10: configurar el móvil
- Problemas habituales en Windows
- Immich no sustituye una copia de seguridad
- ¿Y si Immich no encaja contigo?
- Resumen
- Fuentes oficiales
- Aviso
Qué es Immich y cómo funcionará en Windows
Immich es una aplicación de código abierto para gestionar fotos y vídeos en un servidor propio. Puedes verlos en el navegador y usar apps oficiales para iOS y Android con subida automática. El servidor, su almacenamiento y las copias de seguridad quedan a tu cargo. En esta configuración, Windows 11 ejecuta Docker Desktop sobre WSL2 y Docker Compose inicia los servicios de Immich.
Requisitos antes de instalar
| Requisito | Mínimo | Recomendado |
|---|---|---|
| CPU | 2 núcleos | 4 núcleos |
| RAM para Immich | 6 GB | 8 GB |
| Sistema del servidor | 64 bits | Linux o similar de 64 bits |
Los valores son los requisitos oficiales de Immich; Windows y Docker también consumen memoria. Un PC con solo 8 GB en total puede ir justo, sobre todo durante la creación de miniaturas, transcodificación de vídeo o tareas de aprendizaje automático. Necesitas espacio para originales, base de datos, miniaturas y respaldos.
Paso 1: activar WSL2
Abre PowerShell como administrador desde el menú Inicio y ejecuta:
wsl --install
Sigue las instrucciones y reinicia Windows si se solicita. Al abrir la distribución Linux por primera vez, crea su usuario y contraseña. No publiques esas credenciales en capturas ni en notas compartidas.
Paso 2: instalar Docker Desktop
Descarga Docker Desktop desde su sitio oficial. Usa el backend de WSL2 y activa la integración con la distribución Linux que usarás. Mantén Docker Desktop abierto cuando vayas a iniciar o utilizar Immich. Comprueba los requisitos y condiciones de uso de Docker Desktop aplicables a tu situación.
Paso 3: crear un directorio de trabajo en WSL2
Abre el terminal de tu distribución Linux y crea la carpeta de Immich dentro del sistema de archivos Linux, no en /mnt/c ni /mnt/d:
mkdir -p ~/immich-app
cd ~/immich-app
El símbolo ~ representa el directorio personal de Linux. Esta ubicación es adecuada para el ejemplo porque PostgreSQL necesita permisos y propiedad de archivos compatibles con Unix.
Paso 4: descargar los archivos oficiales de Compose
Desde esa carpeta, descarga los archivos de la versión más reciente siguiendo la guía oficial de Docker Compose:
wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env
Si los descargas con el navegador, cambia el nombre de example.env a .env. No reutilices un archivo Compose antiguo con una versión nueva sin revisar los cambios.
Paso 5: revisar .env
Abre .env con un editor de texto y comprueba UPLOAD_LOCATION (biblioteca), DB_DATA_LOCATION (base de datos), DB_PASSWORD (clave de PostgreSQL) y TZ (zona horaria). Para una primera prueba, las rutas relativas predeterminadas dentro de ~/immich-app son fáciles de entender. Define una contraseña única para la base de datos usando solo letras y números, como recomienda la documentación actual. Ajusta TZ a tu zona, por ejemplo Europe/Madrid o America/Mexico_City; no existe una zona única para todos los países hispanohablantes.
Paso 6: proteger la ubicación de PostgreSQL
No pongas DB_DATA_LOCATION en NTFS, exFAT, FAT32 ni en una carpeta Windows montada en WSL2 bajo /mnt/.... La documentación oficial exige un sistema de archivos compatible con propiedad y permisos Unix. Utiliza el almacenamiento Linux local de WSL2 o un volumen de Docker configurado conforme a la guía oficial. Evita también compartir la base de datos por red; un SSD local es preferible.
UPLOAD_LOCATION es donde van los archivos de fotos y vídeos; DB_DATA_LOCATION guarda los datos de PostgreSQL que organizan usuarios, álbumes y otros metadatos. No son intercambiables. Aunque pongas la biblioteca en otra unidad, mantén la base de datos en un lugar compatible y respaldado.
Paso 7: iniciar Immich
En la carpeta que contiene docker-compose.yml y .env, ejecuta:
docker compose up -d
docker ps
El primer comando descarga e inicia los contenedores; el segundo permite ver su estado. Usa docker compose con espacio: el antiguo docker-compose ya no está admitido por Immich. La primera descarga puede tardar según tu conexión.
Paso 8: abrir Immich en el navegador
En el mismo PC, visita http://localhost:2283. El puerto estándar actual es 2283, no el 3001 que aparece en tutoriales antiguos. Desde otro dispositivo de tu red local, utiliza la dirección IP local del PC y el puerto 2283 si el cortafuegos lo permite. No abras el puerto del router a Internet sin configurar previamente HTTPS, autenticación y mantenimiento de seguridad.
Paso 9: crear la cuenta de administrador
En el primer acceso, registra el primer usuario. Será el administrador de Immich. Usa una contraseña única, comprueba el almacenamiento configurado y revisa que los servicios no entren en un ciclo de reinicios.
Paso 10: configurar el móvil
Instala la app oficial de Immich para Android o iOS, indica la dirección del servidor e inicia sesión. Activa la copia automática de los álbumes que quieras. Antes de subir toda la biblioteca, prueba con unas pocas fotos y vídeos; revisa permisos de ejecución en segundo plano, uso de datos móviles, espacio y fechas de captura. En iPhone, verifica periódicamente que las subidas hayan terminado.
Problemas habituales en Windows
El comando docker compose no arranca
Confirma que Docker Desktop está iniciado, que la integración con WSL2 está habilitada y que estás en el directorio correcto. Debes usar docker compose, no docker-compose.
No se abre localhost:3001
Abre http://localhost:2283. Si cambiaste la asignación de puertos del archivo Compose, utiliza el puerto local que hayas configurado.
PostgreSQL muestra errores de permisos
Revisa DB_DATA_LOCATION. No debe apuntar a NTFS ni a una ruta Windows montada bajo /mnt. Usa almacenamiento Linux local de WSL2 o el volumen Docker descrito en la documentación oficial; comprueba también el espacio libre.
Falta memoria o deja de funcionar tras reiniciar
Immich pide al menos 6 GB de RAM para sus servicios, además de la memoria que necesita Windows. Tras reiniciar el PC, comprueba que Docker Desktop esté abierto y consulta docker ps. Si es necesario, vuelve a ejecutar docker compose up -d en ~/immich-app.
Immich no sustituye una copia de seguridad
Subir fotos a Immich no crea automáticamente un respaldo independiente. Protege tanto la biblioteca de fotos y vídeos como la base de datos. Guarda otra copia en un disco o ubicación diferente y prueba que puedes restaurarla. Un RAID tampoco sustituye al respaldo. La guía oficial de respaldo y restauración explica qué componentes conservar.
¿Y si Immich no encaja contigo?
Antes de dedicar tiempo a mantener un servidor, compara los programas alternativos a Google Fotos y las alternativas a Immich según tus necesidades. Si prefieres indexar carpetas existentes, sigue la guía de PhotoPrism en Windows; digiKam permite organizar archivos sin servidor. Elige según la subida móvil, el control de datos y el mantenimiento que aceptarás.
Resumen
Para probar Immich en Windows 11: prepara WSL2, instala Docker Desktop, descarga los archivos Compose oficiales en el sistema Linux, revisa .env, mantén PostgreSQL fuera de NTFS, inicia los contenedores y abre el puerto 2283. Antes de utilizarlo como biblioteca principal, confirma la carga móvil, el arranque tras reiniciar y la restauración del respaldo.
Fuentes oficiales
Requisitos · Instalación con Docker Compose · Respaldo y restauración · Inicio rápido.
Aviso
Contenido revisado en septiembre de 2026. Immich, Docker Desktop y WSL2 pueden cambiar sus requisitos y procedimientos. Consulta siempre la documentación oficial antes de instalar o migrar. Haz varias copias de tus fotos y comprueba su restauración. La configuración y el cuidado de los datos son responsabilidad de cada usuario.

Comentarios