Офлайн установка
- Скачайте и установите Docker. Минимальная требуемая версия 18.06.0. Официальное статья об установке — https://docs.docker.com/engine/install
- Установите и включите Docker Compose плагин, если он не был установлен ранее. Официальная статья об установке — https://docs.docker.com/compose/install/linux/
Установка Docker и Docker compose на Red OS, Astra Linux и других отечественных диcтрибутивах может отличаться от официальных инструкций для Docker и Docker compose
Мы рекомендуем использовать Docker, установленный не через snap
Для установки Пассворк необходимо скачать файлы и скрипт, который выполнит необходимые действия для установки.
- Создать директорию и перейти в неё:
- Скачать:
- Скрипт установки Пассворка — https://repos.passwork.ru/repository/passwork_docker/passwork_compose_install.sh
- Архив с файлами docker-compose сборки — https://repos.passwork.ru/repository/passwork_docker/passwork_compose_last.tar.gz
- Образ контейнера Percona Server for MongoDB — https://repos.passwork.ru/repository/passwork_docker/images/psmdb5.tar
- Переместить скаченные файлы на Linux сервер в директорию — your_directory, где планируется установка Пассворка
- В созданной директории создать поддиректорию — passwork_images
- Переместить *.tar образы архивы образов в — passwork_images
- Структура файлов и папок после выполнения описанных действий:
Если вы выполняете установку не от имени root — необходимо убедиться, что пользователь состоит в группе docker.
Проверить можно следующим способом:
Добавить пользователя в группу docker можно так:
- Назначить скрипту права на исполнение:
- В директории — your_directory запустить скрипт установки passwork_compose_install.sh с флагом -o
После установки скрипт автоматически выполнит — docker ps. Пожалуйста, проверьте список запущенных контейнеров. Если контейнеры не были запущены, проверьте вывод и лог установки. Пример корректного вывода:
После сборки и запуска контейнеров Пассворк будет доступен по адресу — https://your_servername
По умолчанию Пассворк использует самоподписанный сертификат, который автоматически генерируется при установке, поэтому при первом открытии страницы вы увидите сообщение о том, что браузер не доверяет сертификату сайта.
На первом шаге система предложит выбрать язык интерфейса.
Чек-лист параметров покажет все ли компоненты установлены на вашем сервере.
По умолчанию Пассворк в Docker обращается к сервису c именем db, поэтому необходимо изменить строку подключения на третьем этапе первоначальной установки. Строка подключения — mongodb://db:27017
Пассворк сгенерирует новый ключ для серверного шифрования. Если вы подключаете Пассворк к существующей базе данных, то укажите имеющийся ключ шифрования.
Не вводите ключ, который был сгенерирован не в Пассворк. Пассворк использует специальные безопасные алгоритмы генерации новых ключей в подходящих форматах. Использование ключей, сгенерированных сторонними средствами, может привести к некорректной работе.
Лицензионные ключи можно скачать в вашем клиентском портале Пассворка или запросить у менеджеров.
- После завершения работы скрипта, проверьте работоспособность новой установки и выполните донастройку если это необходимо.
- Для добавления корневых сертификатов почтового сервера или LDAPS в доверенные, необходимо скопировать корневые сертификаты .pem или .crt в директорию ./conf/custom_ca и перезапустить контейнер PHP — docker compose restart passwork_php
- Для изменения используемого сертификата SSL, необходимо скопировать сертификат\цепочку сертификатов в ./conf/ssl/fullchain.pem и приватный ключ в ./conf/ssl/privkey.pem, перезапустить контейнер Nginx — docker compose restart passwork_nginx