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

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

18min

Установка Docker

  1. Скачать и установить Docker версии 18.06.0 или выше. Официальная статья об установке.
  2. Установить и включите плагин Docker Compose. Официальная статья об установке.

Установка 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