8.2.23 Встановлення та налаштування 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
Вкажіть свої параметри:
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
:
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 |
Корисні посилання
Офіційна документація