Docker Compose — рекомендуемый метод для запуска Immich в рабочей среде. Ниже приведены шаги по развертыванию Immich с помощью Docker Compose.
Для Immich требуется Docker Compose версии 2.x.
Шаг 1 — Загрузите необходимые файлы
Создайте каталог по вашему выбору (например, ./immich-app) для хранения файлов docker-compose.yml и .env.Переместите в созданный вами каталог
|
1 |
mkdir ./immich-app<br>cd ./immich-app |
Загрузите docker-compose.yml и example.env, либо выполнив следующие команды, чтобы загрузить файл:
docker-compose.yml
|
1 |
wget <em>-O</em> docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml |
Получить файл .env
|
1 |
wget <em>-O</em> .env https://github.com/immich-app/immich/releases/latest/download/example.env |
(Необязательно) Получить hwaccel.перекодирование.yml-файл
|
1 |
wget <em>-O</em> hwaccel.transcoding.yml https://github.com/immich-app/immich/releases/latest/download/hwaccel.transcoding.yml |
(Необязательно) Получить файл hwaccel.ml.yml
|
1 |
wget <em>-O</em> hwaccel.ml.yml https://github.com/immich-app/immich/releases/latest/download/hwaccel.ml.yml |
или загрузив файлы из вашего браузера и переместив их в созданный вами каталог.
Примечание: После того, как вы загрузили файлы из своего браузера, необходимо переименовать их example.env в .env.
Шаг 2 — Заполните env-файл пользовательскими значениями
Пример .env содержимого
- Укажите
UPLOAD_LOCATIONпредпочтительное местоположение для хранения резервных ресурсов. - Подумайте о замене
DB_PASSWORDна что-то случайно сгенерированное
Пример файла:
|
1 2 3 4 5 6 7 8 9 |
UPLOAD_LOCATION=./library IMMICH_VERSION=release DB_PASSWORD=postgres_pass The values below this line do not need to be changed ###################################################### DB_HOSTNAME=immich_postgres DB_USERNAME=postgres DB_DATABASE_NAME=immich REDIS_HOSTNAME=immich_redis |
Файл должен находиться в той же директории, что и файл docker-compose.yml
Шаг 3 — Запуск контейнеров
Из каталога, созданного вами на шаге 1 (который теперь должен содержать ваши настроенные docker-compose.yml и .env файлы) запустите docker compose up -d.
Запустите контейнеры с помощью команды docker compose
|
1 |
docker compose up <em>-d</em> |
Начнется загрузка образа Docker. По окончании вы должны увидеть экран, похожий на приведенный ниже, информирующий вас о том, что ваша установка Immich успешно развернута и все контейнеры запущены.
Теперь вы можете получить доступ к веб-интерфейсу Immich, перейдя по адресу «http://your-server-ip:2283» в вашем веб-браузере. Если вы получаете доступ к нему с той же машины, на которой запущены контейнеры, вы также можете использовать «http://localhost:2283».
Вы увидите приветственный экран Immich. Нажмите кнопку «Getting Started».
ВЕРСИЯ DOCKER
Если вы получаете сообщение об ошибке unknown shorthand flag: 'd' in -d, вероятно, вы используете неправильную версию Docker. (Это происходит, например, с пакетом docker.ввода-вывода в Ubuntu 22.04.3 LTS.) Вы можете исправить проблему, apt removeустановив пакет docker.ввода-вывода в Ubuntu и установив docker и docker-compose через официальный репозиторий Docker.
Обратите внимание, что правильная команда на самом деле docker compose, а не docker-compose. Если вы попробуете последнюю в ванильной Ubuntu 22.04, она завершится с ошибкой другим способом:
|
1 |
The Compose file './docker-compose.yml' is invalid because:<br>'name' does not match any of the regexes: '^x-' |
Смотрите предыдущий параграф об установке из официального репозитория docker.
СОВЕТ
Для получения дополнительной информации об использовании приложения, пожалуйста, обратитесь к руководству после установки.
АУТЕНТИФИКАЦИЯ НА GITHUB
Для загрузки образов контейнеров может потребоваться аутентификация в реестре контейнеров GitHub (шаги здесь).
Шаг 4 — Обновление
ОСНОВНЫЕ ИЗМЕНЕНИЯ
Важно следить за последними обновлениями, чтобы избежать проблем. Вы можете просмотреть версии, в которые были внесены последние изменения здесь.
Если параметр IMMICH_VERSION установлен, его необходимо будет обновить до последней или желаемой версии.
Когда выпущена новая версия Immich, приложение можно обновить с помощью следующих команд, запускаемых в каталоге с docker-compose.yml файлом:Обновить Immich
|
1 |
docker compose pull && docker compose up <em>-d</em> |
АВТОМАТИЧЕСКИЕ ОБНОВЛЕНИЯ
Immich в настоящее время находится в стадии интенсивной разработки, что означает, что вы можете ожидать критических изменений и ошибок. Поэтому мы рекомендуем ознакомиться с примечаниями к выпуску перед обновлением и соблюдать особую осторожность при использовании автоматизированных инструментов, таких как Сторожевая башня.