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 і 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-сертифікат для безпечного доступу.

Підказка: також для роботи Immich є можливість налаштувати та використовувати SSL сертифікати Let’s Encrypt. Як це зробити детально описано в даній статті.

Налаштування додаткових функцій

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

Корисні посилання

Офіційна документація