8.2.23 Установка и настройка Immich

The Host Banner Immich Immich — это современное self-hosted приложение для хранения и автоматической организации фотографий и видео, аналог Google Photos. Оно поддерживает загрузку с мобильных устройств, распознавание лиц, автоматическую сортировку и резервное хранение в облаке под вашим полным контролем.

В этом руководстве мы рассмотрим процесс установки Immich на сервер с Ubuntu 24.04 с использованием Docker Compose.

Подготовка сервера

Требования

  • Виртуальный или выделенный сервер с установленной Ubuntu 24.04 LTS.
  • Минимум 4 ГБ оперативной памяти (рекомендуется 8 ГБ).
  • Минимум 40 ГБ свободного места на диске (в зависимости от количества фото/видео).
  • Установленные Docker and Docker Compose.

Переменные

  • SERVER_IP_ADDRESS — IP сервера
  • YOUR_DOMAIN — домен для доступа к Immich (например, photos.example.com).
  • YOUR_USER — пользователь на сервере (если не root).
  • IMMICH_PATH — директория для установки Immich (например, /opt/immich).
  • DB_PASSWORD — пароль PostgreSQL.
  • JWT_SECRET — секрет для токенов авторизации.
  • IMMICH_PORT — порт доступа (по умолчанию 2283).

Установка и настройка Immich

Перейдите в рабочую директорию и скачайте официальный репозиторий:

git clone https://github.com/immich-app/immich.git IMMICH_PATH
cd IMMICH_PATH/docker

Настройка переменных окружения

Скопируйте пример файла окружения и отредактируйте его:

cp example.env .env
nano .env

Укажите свои параметры:

IMMICH_PATH/docker/.env
DB_PASSWORD=YOUR_STRONG_DB_PASSWORD
JWT_SECRET=YOUR_RANDOM_JWT_SECRET
IMMICH_PORT=2283

Запуск контейнеров

Запустите сервис:

docker compose up -d

Проверьте статус:

docker compose ps

Если все контейнеры в статусе Up, приложение работает.

Доступ к Immich

По умолчанию Immich доступен по адресу:

http://`SERVER_IP_ADDRESS`:2283

Рекомендуется настроить домен и SSL-сертификат для безопасного доступа.

Полную инструкцию смотрите в нашей статье: Certbot.

Настройка дополнительных функций

SMTP-рассылки

Immich поддерживает отправку email-уведомлений (например, восстановление пароля). Отредактируйте .env:

IMMICH_PATH/docker/.env
EMAIL_HOST=smtp.example.com
EMAIL_PORT=587
EMAIL_USER=your_user@example.com
EMAIL_PASSWORD=your_password
EMAIL_FROM=immich@example.com

Резервное копирование

Рекомендуется регулярно сохранять:

  • Базу данных PostgreSQL (pg_dump).
  • Директорию с загруженными фото/видео (upload/).

Пример бэкапа базы:

docker exec -t immich_postgres pg_dump -U postgres immich > backup.sql
Распространённые ошибки
Ошибка / Симптом Причина Решение Диагностика (логи / команды)
container exited (1) Неверные переменные окружения Проверьте .env и исправьте значения docker compose logs
Нет доступа к веб-интерфейсу Порт закрыт или занят другим процессом Убедитесь, что порт 2283 открыт, либо измените IMMICH_PORT ss -tulpn / grep 2283
Ошибка подключения к базе Неверный пароль PostgreSQL Проверьте DB_PASSWORD в .env docker compose logs postgres

Полезные ссылки

Официальная документация