Требования
Требования к оборудованию и программному обеспечению для Immich:
Оборудование
- ОС: Рекомендуется операционная система Linux или *nix (Ubuntu, Debian и т.д.).
- ОС, отличные от Linux, как правило, предоставляют плохой опыт работы с Docker и настоятельно не рекомендуются.
Наша возможность помочь в настройке или устранении неисправностей на ОС, не являющихся Linux, будет значительно снижена.
Если вы все же хотите попробовать использовать ОС, отличную от Linux, вы можете настроить её следующим образом:
- Windows: Docker Desktop на Windows или WSL 2.
- macOS: Docker Desktop на Mac.
- Immich хорошо работает в виртуализированной среде при использовании полного виртуального к омпьютера. Использование Docker в контейнерах LXC не рекомендуется, но может быть возможно для опытных пользователей. Если у вас возникнут проблемы, мы рекомендуем переключиться на поддерживаемое развертывание виртуальных машин.
- ОС, отличные от Linux, как правило, предоставляют плохой опыт работы с Docker и настоятельно не рекомендуются.
Наша возможность помочь в настройке или устранении неисправностей на ОС, не являющихся Linux, будет значительно снижена.
Если вы все же хотите попробовать использовать ОС, отличную от Linux, вы можете настроить её следующим образом:
- ОЗУ: Минимум 4 GB, рекомендуется 6 GB.
- ЦП: Минимум 2 ядра, рекомендуется 4 ядра.
- Хранилище: Рекомендуется совместимая с Unix файловая система (EXT4, ZFS, APFS и т.д.) с поддержкой владения пользователями/группами и разрешений.
- Создание миниатюр и транскодированных видео может увеличить размер фототеки в среднем на 10-20%.
Хорошая производительность и стабильное подключение к базе данных Postgres критически важны для плавной работы Immich.
Файлы базы данных Postgres обычно занимает от 1 до 3 GB.
По этой причине база данных Postgres (DB_DATA_LOCATION) должна использовать локальное SSD-хранилище и никогда сетевое хранилище.
Кроме того, если используются ограничения ресурсов Docker, база данных Postgres требует минимум 2GB ОЗУ.
Пользователи Windows могут столкнуться с проблемами из-за несовместимых с Unix файловых систем, подробнее см. ниже.
Программное обеспечение
Immich требует Docker с плагином Docker Compose:
- Docker Engine: Этот вариант CLI предназначен для серверов на Linux (или Windows через WSL2).
- Docker Desktop: Этот вариант GUI не рекомендуется для Linux, но доступен для Windows или macOS.
Плагин Compose будет установлен как Docker Engine, так и Desktop при следовании предоставленным инструкциям по установке; он также может быть установлен отдельно.
Immich требует команды docker compose; аналогичная команда с названием docker-compose является устаревшей и больше не поддерживается Immich.
Особые требования для пользователей Windows
Хранилище базы данных на системах Windows
База данных Postgres Immich (DB_DATA_LOCATION) должна находиться на файловой системе, поддерживающей владение пользователями/группами
и разрешения (EXT2/3/4, ZFS, APFS, BTRFS, XFS и т.д.). Она не будет работать на любой файловой системе, отформатированной как NTFS или ex/FAT/32.
Она также не будет работать в WSL (Windows Subsystem for Linux) при использовании смонтированного хостового каталога (обычно в /mnt).
Если это проблема, вы можете изменить монтирование с привязкой на том Docker следующим образом:
Внесите следующие изменения в файл .env:
- DB_DATA_LOCATION=./postgres
+ DB_DATA_LOCATION=pgdata
Добавьте следующую строку в нижнюю часть файла docker-compose.yml:
volumes:
model-cache:
+ pgdata: