8.2.23 Установка и настройка 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
Укажите свои параметры:
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 |
Полезные ссылки
Официальная документация