Стандартная установка
Linux

Офлайн установка

18min

Установка Docker

  1. Скачайте и установите Docker. Минимальная требуемая версия 18.06.0. Официальное статья об установке — https://docs.docker.com/engine/install
  2. Установите и включите Docker Compose плагин, если он не был установлен ранее. Официальная статья об установке — https://docs.docker.com/compose/install/linux/

Установка Docker и Docker compose на Red OS, Astra Linux и других отечественных диcтрибутивах может отличаться от официальных инструкций для Docker и Docker compose

Мы рекомендуем использовать Docker, установленный не через snap

Подготовка окружения для оффлайн установки

Для установки Пассворк необходимо скачать файлы и скрипт, который выполнит необходимые действия для установки.

  • Создать директорию и перейти в неё:
Shell

Shell

  • Переместить *.tar образы архивы образов в — passwork_images
Shell

  • Структура файлов и папок после выполнения описанных действий:
Shell


Проверка прав пользователя

Если вы выполняете установку не от имени root — необходимо убедиться, что пользователь состоит в группе docker.

Проверить можно следующим способом:

Shell


Добавить пользователя в группу docker можно так:

Shell


Запуск скрипта оффлайн установки

  • Назначить скрипту права на исполнение:
Shell

  • В директории — your_directory запустить скрипт установки passwork_compose_install.sh с флагом -o
Shell


После установки скрипт автоматически выполнит — docker ps. Пожалуйста, проверьте список запущенных контейнеров. Если контейнеры не были запущены, проверьте вывод и лог установки. Пример корректного вывода:

Document image


Настройка Пассворк

После сборки и запуска контейнеров Пассворк будет доступен по адресу — https://your_servername

По умолчанию Пассворк использует самоподписанный сертификат, который автоматически генерируется при установке, поэтому при первом открытии страницы вы увидите сообщение о том, что браузер не доверяет сертификату сайта.

Выбор языка

На первом шаге система предложит выбрать язык интерфейса.

Document image


Проверка параметров системы

Чек-лист параметров покажет все ли компоненты установлены на вашем сервере.

Document image


Подключение базы данных

По умолчанию Пассворк в Docker обращается к сервису c именем db, поэтому необходимо изменить строку подключения на третьем этапе первоначальной установки.  Строка подключения — mongodb://db:27017

Document image


Ключ шифрования

Пассворк сгенерирует новый ключ для серверного шифрования. Если вы подключаете Пассворк к существующей базе данных, то укажите имеющийся ключ шифрования.

Не вводите ключ, который был сгенерирован не в Пассворк. Пассворк использует специальные безопасные алгоритмы генерации новых ключей в подходящих форматах. Использование ключей, сгенерированных сторонними средствами, может привести к некорректной работе.

Document image


Лицензионные ключи

Лицензионные ключи можно скачать в вашем клиентском портале Пассворка или запросить у менеджеров.

Document image


Дополнительные настройки после установки

  • После завершения работы скрипта, проверьте работоспособность новой установки и выполните донастройку если это необходимо.
  • Для добавления корневых сертификатов почтового сервера или 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