Saltar al contenido principal

Configuración del sistema

El usuario administrador puede gestionar la configuración de la instancia de Immich aquí.

consejo

Siempre puedes volver a la configuración predeterminada haciendo clic en el botón Restablecer a los valores predeterminados.

Configuración de autenticación

Gestiona la contraseña, OAuth, y otras configuraciones de autenticación.

Autenticación con OAuth

Immich es compatible con la autenticación OAuth. Lee más sobre esta función y su configuración aquí.

Autenticación con contraseña

El administrador puede optar por desactivar el inicio de sesión con nombre de usuario y contraseña para toda la instancia. Esto significa que nadie, incluido el administrador del sistema, podrá iniciar sesión usando este método. Si la Autenticación OAuth también está desactivada, ningún usuario podrá iniciar sesión usando ningún método. Cambiar esta configuración no afecta las sesiones existentes, solo los nuevos intentos de inicio de sesión.

consejo

Siempre puedes usar el CLI del servidor para volver a habilitar el inicio de sesión con contraseña.

Configuración de imágenes (miniaturas y vistas previas)

  • Miniaturas - Usadas en la línea de tiempo principal.
  • Vistas previas - Usadas en el visor de assets.

Por defecto, Immich genera 3 miniaturas para cada asset, Desenfocadas (thumbhash), Pequeñas - miniaturas (webp) y Grandes - vistas previas (jpeg/webp). Con estas configuraciones puedes cambiar la calidad de los archivos de miniaturas y vistas previas que se crean.

Formato de las miniaturas
Permite elegir el tipo de formato que deseas para las miniaturas. Webp produce archivos más pequeños que jpeg, pero es más lento al codificar.

consejo

Puedes leer en detalle sobre las ventajas y desventajas de usar webp en lugar de jpeg en el sitio web de Adobe.

Resolución de miniaturas
Se usa al ver grupos de fotos (línea de tiempo principal, vista de álbum, etc.). Resoluciones más altas pueden preservar más detalles, pero toman más tiempo en codificarse, tienen tamaños de archivo más grandes y pueden reducir la capacidad de respuesta de la aplicación.

Formato de vistas previas
Permite elegir el tipo de formato que deseas para las vistas previas. Webp produce archivos más pequeños que jpeg, pero es más lento al codificar.

Resolución de vistas previas
Se usa al ver una sola foto y para aprendizaje automático. Resoluciones más altas pueden preservar más detalles, pero toman más tiempo en codificarse, tienen tamaños de archivo más grandes y pueden reducir la capacidad de respuesta de la aplicación.

Calidad
Calidad de imagen de 1 a 100. Un valor más alto es mejor para la calidad pero produce archivos más grandes. Esta opción afecta a las imágenes de vistas previas y miniaturas.

Preferir amplia gama de colores
Usa Display P3 para las miniaturas. Esto preserva mejor la intensidad de las imágenes con espacios de color amplios, pero puede que las imágenes se vean diferentes en dispositivos antiguos con navegadores antiguos. Las imágenes en sRGB se mantienen en sRGB para evitar cambios en los colores.

Preferir vistas previas incrustadas
Usa vistas previas incrustadas en fotos RAW como entrada para el procesamiento de imágenes cuando estén disponibles. Esto puede producir colores más precisos para algunas imágenes, pero la calidad de la vista previa depende de la cámara y la imagen puede tener más artefactos de compresión.

consejo

La resolución predeterminada para miniaturas grandes se puede reducir de 1440p (predeterminado) a 1080p o 720p para ahorrar espacio de almacenamiento.

Configuración de trabajos

Con estas configuraciones, puedes determinar la cantidad de trabajo que se ejecutará simultáneamente para cada tarea en los microservicios. Algunas tareas se pueden configurar con valores más altos en computadoras con hardware potente y almacenamiento con buenas capacidades de entrada/salida.

Con una mayor simultaneidad, el host trabajará en más assets en paralelo, este consejo mejora el rendimiento total, no la latencia. Por ejemplo, hará que los trabajos de búsqueda inteligente se procesen más rápidamente, pero no hará que las búsquedas sean más rápidas.

Es importante recordar que trabajos como Búsqueda Inteligente, Detección Facial, Reconocimiento Facial y Codificación de Videos requieren mucho poder de procesamiento, por lo tanto, no exageres en la cantidad de trabajos porque probablemente sobrecargarás completamente el servidor.

IMPORTANTE

Si aumentas la concurrencia desde los valores predeterminados que establecimos, especialmente para la generación de miniaturas, asegúrate de no aumentarlos más allá de la cantidad de núcleos de CPU que tienes disponibles. Hacerlo puede impactar la capacidad de respuesta de la API sin ningún beneficio en la velocidad de generación de miniaturas.

Concurrencia en Reconocimiento Facial

El valor de concurrencia en Reconocimiento Facial no puede ser cambiado porque DBSCAN es tradicionalmente secuencial, aunque existen implementaciones paralelas del mismo. Nuestra implementación no es paralela.

Biblioteca externa

Monitoreo de la biblioteca (EXPERIMENTAL)

Las bibliotecas externas pueden importar automáticamente los archivos modificados sin un escaneo completo. Importará el archivo cada vez que el sistema operativo informe un cambio en el archivo. Si tus fotos están montadas en red, esto no funcionará.

Escaneo periódico

Puedes definir un intervalo personalizado para el escaneo de resincronización de la biblioteca externa en Administración -> Configuración -> Biblioteca. Puedes definir el intervalo de escaneo usando el formato preestablecido o cron. Para más información, consulta por ejemplo: Crontab Guru.

Registros de inicio (logs)

El nivel de registro predeterminado de Immich es Log (conocido comúnmente como Info). El administrador de Immich puede elegir un nivel de registro más alto o más bajo según su preferencia personal o según lo solicite el equipo de soporte de Immich.

Configuración de aprendizaje automático

Con esta configuración, puedes gestionar todas las configuraciones relacionadas con el aprendizaje automático en Immich, desde ajustar el aprendizaje remoto hasta el modelo y sus parámetros. Puedes optar por desactivar cierto tipo de aprendizaje automático, por ejemplo, búsqueda inteligente o reconocimiento facial.

URL

El servidor de aprendizaje automático incorporado (http://immich-machine-learning:3003) estará configurado por defecto, pero puedes cambiarlo o agregar servidores adicionales.

Alojar el contenedor immich-machine-learning en una máquina con una GPU más potente puede ser útil para procesar un gran número de fotos (como durante una importación masiva) o para búsquedas más rápidas.

Si se proporciona más de una URL, cada servidor será intentado uno por uno hasta que uno responda con éxito, en orden de primero a último. Los servidores que no respondan serán ignorados temporalmente hasta que vuelvan a estar en línea.

Búsqueda Inteligente

La configuración de búsqueda inteligente permite cambiar el modelo CLIP. Los modelos más grandes generalmente proporcionan resultados de búsqueda más precisos, pero consumen más poder de procesamiento y RAM. Al cambiar el modelo CLIP, es obligatorio volver a ejecutar el trabajo de Búsqueda Inteligente en todas las imágenes para aplicar el cambio completamente.

Conexión a Internet

Cambiar modelos requiere una conexión a Internet para descargar el modelo. Una vez descargado, no es necesario que Immich se conecte a la red. A menos que la verificación de versiones esté habilitada en la configuración.

Detección de duplicados

Usa embeddings CLIP para encontrar posibles duplicados. La distancia máxima de detección puede configurarse para mejorar/reducir el nivel de precisión.

  • Distancia máxima de detección - Distancia máxima entre dos imágenes para considerarlas duplicadas, que varía entre 0.001 y 0.1. Valores más altos detectarán más duplicados, pero pueden producir falsos positivos.

Reconocimiento facial

En esta configuración, puedes cambiar los ajustes del reconocimiento facial. Opciones editables:

  • Modelo de Reconocimiento Facial
  • Puntaje mínimo de detección
  • Distancia máxima de reconocimiento
  • Mínimo de caras reconocidas

Puedes aprender más sobre estas opciones en la página de reconocimiento facial.

información

Al cambiar los valores en Puntaje mínimo de detección, Distancia máxima de reconocimiento, y Mínimo de caras reconocidas. Deberás reiniciar solo el trabajo de RECONOCIMIENTO FACIAL - TODO.

Si reemplazas el Modelo de Reconocimiento Facial, tendrás que ejecutar el trabajo de DETECCIÓN FACIAL - TODO.

gemelos idénticos

Si tienes gemelos, podrías querer reducir el valor de Distancia máxima de reconocimiento. Reducirlo un poco puede ayudar a distinguir entre ellos.

Configuración de mapas y GPS

Configuración de mapas

En esta configuración, puedes modificar la apariencia del mapa en modos nocturno y diurno según tu preferencia personal y las opciones compatibles. El mapa se puede ajustar a través de OpenMapTiles, por ejemplo.

Configuración de geocodificación inversa

Immich es compatible con la geocodificación inversa usando datos de la base de datos geográfica de GeoNames.

Configuración de notificaciones

Configuración del servidor SMTP, para notificaciones de creación de usuarios, nuevos álbumes, etc. Más información se puede encontrar aquí.

Plantillas de notificaciones

Sobrescribe el texto predeterminado de notificaciones con plantillas de notificaciones. Más información se puede encontrar aquí.

Configuración del servidor

Dominio externo

Sobrescribe el nombre del dominio en los enlaces compartidos y notificaciones por correo electrónico. La URL no debe incluir una barra al final.

Mensaje de bienvenida

El administrador puede configurar un mensaje personalizado en la pantalla de inicio de sesión (el mensaje se mostrará a todos los usuarios).

Plantilla de almacenamiento

Immich es compatible con una Plantilla de Almacenamiento personalizada. Aprende más sobre esta función y su configuración aquí.

Configuración de tema

Puedes escribir CSS personalizado que se cargará en la aplicación web para todos los usuarios. Esto permite a los administradores cambiar fuentes, colores, y otros estilos.

Por ejemplo:

CSS personalizado
p {
color: green;
}

Configuración de papelera

El sistema permite al administrador configurar una papelera para archivos eliminados. Estos archivos permanecerán en la papelera hasta la fecha de eliminación, que por defecto es de 30 días o como lo defina el administrador.

La papelera puede desactivarse, pero no es lo recomendado, ya que los archivos eliminados en el futuro serán permanentemente borrados.

Atajo de teclado para eliminación permanente

Puedes seleccionar assets y presionar Ctrl + Del desde la línea de tiempo para eliminarlos permanentemente sin usar la opción de papelera.

Configuración de usuarios

Retraso en eliminación

El administrador del sistema puede elegir eliminar usuarios a través del panel de administración. El administrador del sistema puede eliminar usuarios de inmediato o, alternativamente, retrasar la eliminación para los usuarios (7 días por defecto). Esta acción elimina permanentemente la cuenta y los activos de un usuario. La tarea de eliminación de usuarios se ejecuta a medianoche para verificar los usuarios listos para ser eliminados. Los cambios en esta configuración serán evaluados en la próxima ejecución.

Comprobación de versión

Cuando esta opción está habilitada, el immich-server realizará solicitudes periódicas a GitHub para verificar nuevas versiones.

Configuración de transcodificación de video

El administrador del sistema puede configurar qué archivos de video serán convertidos a diferentes formatos. La configuración se puede cambiar en profundidad. Para obtener más información sobre la terminología utilizada aquí, consulte la documentación de FFmpeg para el códec H.264, el códec HEVC y el códec VP9.

Qué flujos de un archivo de video serán transcodificados se determina mediante la Política de Transcodificación. Los flujos transcodificados utilizan la configuración siguiente (nombre del archivo de configuración entre paréntesis). Los flujos que no son transcodificados permanecen intactos y conservan su configuración original.

Contenedores aceptados (ffmpeg.acceptedContainers)

Si el formato del contenedor del activo de video no está en esta lista, se remuxará a MP4 incluso si no es necesario transcodificar ningún flujo.

El conjunto predeterminado de formatos de contenedor aceptados es mov, ogg y webm.

Configuración (ffmpeg.preset)

La cantidad de "esfuerzo computacional" para realizar la transcodificación. Estos utilizan los nombres preconfigurados de h264 y serán convertidos a valores apropiados para codificadores que configuren el esfuerzo de distintas maneras.

El valor predeterminado es ultrafast.

Códec de audio (ffmpeg.targetAudioCodec)

Qué códec de audio usar cuando se transcodifique el flujo de audio. Puede ser uno de mp3, aac, libopus.

El valor predeterminado es aac.

Códec de video (ffmpeg.targetVideoCodec)

Qué códec de video usar cuando se transcodifique el flujo de video. Puede ser uno de h264, hevc, vp9 o av1.

El valor predeterminado es h264.

Resolución objetivo (ffmpeg.targetResolution)

Al transcodificar un flujo de video, reducir la dimensión más grande a este valor mientras se preserva la relación de aspecto. Los videos nunca se escalan hacia arriba.

El valor predeterminado es 720.

Política de transcodificación (ffmpeg.transcode)

La política de transcodificación configura qué flujos de un activo de video serán transcodificados. La decisión de transcodificación se realiza de manera independiente para los flujos de video y audio. Esto significa que si un flujo de video necesita ser transcodificado pero un flujo de audio no, entonces el flujo de video será transcodificado mientras que el flujo de audio será copiado. Si la política de transcodificación no requiere que se transcodifique ningún flujo ni que el video sea remuxado, entonces no se creará ningún archivo de video separado.

La política predeterminada es required.

Todos los videos (all)

Los videos siempre se transcodifican. Esto garantiza consistencia durante la reproducción de video.

No transcodificar ningún video (disabled)

Los videos nunca se transcodifican. Esto ahorra espacio y recursos en el servidor, pero puede impedir la reproducción en dispositivos que no admitan el formato original (especialmente navegadores web) o resultar en un uso elevado de ancho de banda al reproducir archivos de alta tasa de bits.

Solo videos que no están en un formato aceptado (required)

Los flujos de video se transcodifican cuando se cumple alguna de las siguientes condiciones:

  • El video es HDR.
  • El video no está en el formato de píxel yuv420p.
  • El códec de video no está en acceptedVideoCodecs.

El audio se transcodifica si el códec de audio no está en acceptedAudioCodecs.

Videos con tasa de bits superior al máximo o no en un formato aceptado (bitrate)

Además de las condiciones en required, los flujos de video también se transcodifican si su tasa de bits supera el maxBitrate.

Videos con resolución superior a la objetivo o no en un formato aceptado (optimal)

Además de las condiciones en required, los flujos de video también se transcodifican si tanto las dimensiones horizontales como verticales son mayores que targetResolution.