Technical Anshu
Tutorials Blog
📸 Instalación de Immich Docker

Instale Immich con Docker para su propia nube de fotografías privada

El almacenamiento de Google Fotos se llena, los precios suben y los recuerdos de tu familia permanecen en la computadora de otra persona. Immich coloca una nube de fotografías completa (línea de tiempo, álbumes, búsqueda de rostros, copia de seguridad automática del teléfono) en una máquina en su propia casa. Aquí está la instalación honesta completa, en el orden en que funciona.

✍️ Technical Anshu🐳 Docker / Linux Server⏱️ 15 minute install
🎥 Mire el método más rápido en el video: instalación completa de Immich Docker, paso a paso

Immich es lo más parecido a Google Fotos en tu propio hardware: tu teléfono realiza copias de seguridad automáticamente, las fotos aparecen en una línea de tiempo limpia y puedes buscar por rostro, lugar u objeto. La instalación es muy corta: dos archivos para descargar, un archivo para editar, un comando para ejecutar, pero las pocas opciones dentro de ese archivo deciden si su biblioteca está segura durante años o es frágil desde el primer día. Esta guía toma esas decisiones con cuidado.

Terminal — the whole install is four commands
$ mkdir ./immich-app && cd ./immich-app $ 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 $ docker compose up -d

👆 La ruta de instalación oficial de la documentación de Immich: dos archivos descargados, un comando y el servidor está activo.

1

Lo que necesitas antes de comenzar

Immich es una plataforma de copia de seguridad de fotografías y vídeos autohospedada; piense en Google Photos, pero el servidor es una máquina en su propia casa y nadie más guarda sus fotografías. Es gratuito y de código abierto, y la forma oficial de ejecutarlo es Docker Compose en un servidor Linux, una PC antigua, una mini PC o un NAS que admita Docker.

  1. Una máquina que permanece en: una mini PC, una computadora de escritorio antigua, un servidor doméstico o un NAS. Una computadora portátil que duerme todas las noches es un mal servidor de fotografías
  2. Docker y Docker Compose instalados y funcionando: pruébelo con docker compose version
  3. RAM: alrededor de 4 GB es el mínimo práctico; el contenedor de aprendizaje automático es la parte hambrienta, por lo que 6-8 GB es notablemente más feliz
  4. Almacenamiento: su biblioteca de fotos completa, más aproximadamente entre un 10 y un 20 por ciento adicional para miniaturas y vídeos transcodificados. El almacenamiento, no la CPU, es lo primero que se le acabará
  5. Expectativa honesta: Immich es un proyecto joven en desarrollo activo. Es excelente, pero los propios desarrolladores siempre han aconsejado mantener otra copia de seguridad de las fotografías irremplazables. Esta guía sigue ese consejo en todas partes.
2

Descargue los dos archivos oficiales

Nunca copie un archivo aleatorio de Docker-Compose de un blog o una publicación en un foro: las versiones varían y el archivo de un extraño puede vincularlo a una compilación antigua. Los archivos oficiales siempre se encuentran en la página de lanzamiento de GitHub del proyecto:

  1. Cree la carpeta: mkdir ./immich-app y muévase a ella con cd ./immich-app
  2. Descargue el archivo de redacción: wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
  3. Descargue la plantilla de entorno: wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env
  4. Tenga en cuenta el cambio de nombre en ese segundo comando: la plantilla se llama example.env, pero Docker solo la lee si el archivo se llama exactamente .env
3

Edite el archivo .env: la única configuración que importa

El archivo .env contiene los pocos valores que Immich no puede adivinar. Ábrelo con nano .env y configura esto:

  1. UPLOAD_LOCATION=./library: donde residirán tus fotos y vídeos originales. Apunte esto a su disco más grande y confiable. Debe ser una carpeta con suficiente espacio libre para toda la biblioteca.
  2. DB_DATA_LOCATION=./postgres: donde reside la base de datos. Guárdelo en un SSD local. La documentación de Immich es contundente: los recursos compartidos de red no son compatibles con la base de datos y ejecutarla sobre uno puede dañarla.
  3. DB_PASSWORD=: cámbiela por una contraseña larga y aleatoria. Utilice solo letras y números (A-Z, a-z, 0-9): los caracteres especiales pueden interrumpir el análisis del archivo por parte de Docker.
  4. TZ=Asia/Kolkata: descomente y configure su zona horaria para que las fechas de las fotografías y los trabajos programados se alineen
  5. Deje IMMICH_VERSION y todo lo que esté debajo de la línea marcada solo para una primera instalación
4

Inicie la pila y cree la cuenta de administrador

  1. Ejecute docker compose up -d: Docker descarga cuatro imágenes de contenedor y las inicia juntas. La primera ejecución tarda unos minutos dependiendo de su velocidad de Internet.
  2. Verifique todo lo que surgió con docker compose ps: debería ver el servidor, el aprendizaje automático, la base de datos y los contenedores de Redis ejecutándose.
  3. Abra http://YOUR-SERVER-IP:2283 en un navegador en la misma red. Immich responde en el puerto 2283
  4. Haga clic en la pantalla de bienvenida y regístrese. La primera cuenta creada se convierte en administrador; así que realice este paso usted mismo, inmediatamente, antes de que alguien más en su red encuentre la página.
  5. Dentro, abra Administración y ejecute las comprobaciones de almacenamiento y biblioteca. Luego instale la aplicación gratuita Immich en su teléfono, inicie sesión con la misma dirección del servidor y active la copia de seguridad automática.
5

Lo que acaba de empezar: cuatro contenedores, cuatro puestos de trabajo

El archivo de redacción que descargaste ejecuta un equipo pequeño, no un solo programa:

  1. servidor-immich: el cerebro. La interfaz web, la API con la que habla su teléfono, cargas, álbumes, uso compartido y búsqueda
  2. immich-machine-learning: los ojos. La detección de rostros, el reconocimiento de rostros y la búsqueda inteligente se ejecutan aquí, en segundo plano.
  3. base de datos (PostgreSQL): la memoria. El nombre, la fecha, el álbum, la cara y los datos de búsqueda de cada foto se encuentran aquí. Los originales son archivos; el significado está en esta base de datos
  4. redis: el mensajero. Pasa trabajos entre el servidor y los trabajadores en segundo plano.

Conocer esta división será importante más adelante: si la búsqueda se interrumpe, se comprueba el aprendizaje automático; Si las fotos desaparecen de la línea de tiempo pero los archivos todavía están en el disco, verifica la base de datos. La guía complementaria de esta página decodifica cada servicio en su totalidad.

6

Las tres reglas a seguir desde el primer día

  1. Lea antes de actualizar. Immich publica versiones con frecuencia y algunas contienen cambios importantes que necesitan un paso de actualización específico. Dos minutos con las notas de la versión superan a un fin de semana de recuperación
  2. Haga una copia de seguridad del par, no solo de las fotos. Los archivos de su biblioteca sin la base de datos pierden sus álbumes, caras y organización. Una copia de seguridad real cubre ambos
  3. Nunca exponga el puerto sin formato a Internet. El puerto 2283 en su red doméstica está bien. En Internet abierta, utilice una VPN o un túnel: la guía de acceso remoto de esta página explica por qué y cómo

Siga esos tres y Immich será una nube privada genuinamente confiable. Ignórelos y el mismo software se convertirá en una advertencia: la diferencia son los hábitos, no la herramienta.

🔴 La nota de honestidad que da el propio Immich: el proyecto está en desarrollo activo y cambia rápidamente. Trate a Immich como su plataforma de fotografías, no como su única copia. Mantenga una copia de seguridad separada de la biblioteca y la base de datos: la guía de copia de seguridad vinculada desde esta página muestra la rutina completa.

🎥 Mira el proceso completo en el vídeo

La instalación completa (configuración del servidor, conexión de la aplicación del teléfono y primera copia de seguridad) se muestra en vivo en el video.

▶️ Watch Full Video
❓ Preguntas frecuentes

¿Immich es realmente gratuito o existe un nivel pago?

Immich es gratuito y de código abierto bajo la licencia AGPL, y el proyecto se ha comprometido a mantener todas las funciones gratuitas: no existe un nivel de pago. Existe una compra opcional únicamente para apoyar a los desarrolladores y no desbloquea nada. Sus costos reales son su propio hardware y electricidad.

¿Cuánta RAM y almacenamiento necesita realmente Immich?

Planifique unos 4 GB de RAM como base (el contenedor de aprendizaje automático es la parte más importante) y un almacenamiento equivalente a toda su biblioteca de fotografías, más aproximadamente entre un 10 y un 20 por ciento adicional para miniaturas y vídeos transcodificados. El almacenamiento se agota mucho antes que la CPU.

¿Puedo ejecutar Immich en Windows o Raspberry Pi?

La ruta oficial admitida es Docker en Linux, que incluye la mayoría de los sistemas NAS y mini PC. En Windows, la ruta práctica es Docker dentro de WSL2 o una pequeña máquina virtual Linux. Una Raspberry Pi puede ejecutarlo, pero los trabajos de reconocimiento facial y vídeo serán lentos; una mini PC usada y barata es un hogar mucho más feliz para ella.

Esta guía se basa en el vídeo técnico de Anshu vinculado anteriormente. • ¿Atascado en un escalón? Pregunte en los comentarios del vídeo: ahí es donde las respuestas llegan más rápido 🙏