Онлайн установка
Пассворк не требователен к ресурсам сервера(-ов). Объемы необходимых ресурсов (RAM, CPU, HDD) и количество серверов зависят от количества активных пользователей, объема хранимых данных, а также требований к отказоустойчивости системы.
Технические требования — подробное описание технических требований
Рекомендуется включить SWAP файл для корректной сборки всех библиотек, если на сервере 2-4 ГБ RAM
DEB-based
RPM-based
- Скачайте и установите Docker. Минимальная требуемая версия 18.06.0. Официальное статья об установке — https://docs.docker.com/engine/installation/
- Установите и включите Docker Compose плагин, если он не был установлен ранее. Официальная статья об установке — https://docs.docker.com/compose/install/linux/
Установка Docker и Docker compose на Red OS, Astra Linux и других отечественных диcтрибутивах может отличаться от официальных инструкций для Docker и Docker compose
Мы рекомендуем использовать Docker, установленный не через snap
Для установки Пассворка необходимо скачать и запустить скрипт, который установит необходимые компоненты для работы скриптов.
Создать директорию и перейти в нее:
Скопировать скрипт установки:
Проверьте хеш от файла passwork_compose_install.sh, чтобы убедиться в подлинности файла:
Система должна выдать сообщение passwork_compose_install.sh: OK
Если вы выполняете установку не от имени root — необходимо убедиться, что пользователь состоит в группе docker.
Проверить можно следующим способом:
Добавить пользователя в группу docker можно так:
Дать скрипту права запуска и запустить его:
Скрипт использует apt или dnf, а также curl. Если в вашей сети используется прокси-сервер, необходимо добавить переменные окружения: export http_proxy=http://proxy.example.com:8080 export https_proxy=http://proxy.example.com:8080
Процесс выполнения скрипта установки
Скрипт выполнит проверку прав текущего пользователя, а также версии необходимых компонентов. В случае возникновения ошибок скрипт создаст лог в формате install_log_date.log и поместит в него ошибки:
![Document image Document image](https://images.archbee.com/jvwmQL6VASLd-norgNd8V/SCIOYWB542CPmcBUqZQPX_izobrazhenie.png?format=webp)
В процессе выполнения будет запрошен номер сертификата из клиентского портала:
![Document image Document image](https://images.archbee.com/jvwmQL6VASLd-norgNd8V/m2xX9LDeC8zjjHCFh_w94_cleanshot-2023-11-02-at-1711062x.png?format=webp)
После окончания выполнения скрипта
Скрипт автоматически выполнит docker ps. Пожалуйста, проверьте список запущенных контейнеров. Если контейнеры не были запущены, проверьте вывод и лог установки. Пример корректного вывода:
![Document image Document image](https://images.archbee.com/jvwmQL6VASLd-norgNd8V/Kdv74q-d18hXPWpmK5n5__image.png?format=webp)
После сборки и запуска контейнеров Пассворк будет доступен по ссылке https://your_servername.
По умолчанию Пассворк использует самоподписанный сертификат, который автоматически генерируется при установке, поэтому при первом открытии страницы вы увидите сообщение о том, что браузер не доверяет сертификату сайта.
На первом шаге система предложит выбрать язык интерфейса.
![Document image Document image](https://images.archbee.com/jvwmQL6VASLd-norgNd8V/YJskRJnh_4A7I_tbGvRXD_cleanshot-2023-11-02-at-1702042x.png?format=webp)
Чек-лист параметров покажет все ли компоненты установлены на вашем сервере.
![Document image Document image](https://images.archbee.com/jvwmQL6VASLd-norgNd8V/ydM1LIMrSEOttu-qvFwUc_cleanshot-2023-11-02-at-1702352x.png?format=webp)
По умолчанию Пассворк в Docker обращается к сервису c именем db, поэтому необходимо изменить строку подключения на третьем этапе первоначальной установки. Строка подключения — mongodb://db:27017
![Document image Document image](https://images.archbee.com/jvwmQL6VASLd-norgNd8V/GJbMkMF-6xcjXG6nSx8py_cleanshot-2023-11-02-at-1716262x.png?format=webp)
Пассворк сгенерирует новый ключ для серверного шифрования. Если вы подключаете Пассворк к существующей базе данных, то укажите имеющийся ключ шифрования.
Не вводите ключ, который был сгенерирован не в Пассворк. Пассворк использует специальные безопасные алгоритмы генерации новых ключей в подходящих форматах. Использование ключей, сгенерированных сторонними средствами, может привести к некорректной работе.
![Document image Document image](https://images.archbee.com/jvwmQL6VASLd-norgNd8V/MXp0BNwMXy56lL3GT1bBh_cleanshot-2023-11-02-at-1717012x.png?format=webp)
Лицензионные ключи можно скачать в вашем клиентском портале Пассворка или запросить у менеджеров.
![Document image Document image](https://images.archbee.com/jvwmQL6VASLd-norgNd8V/s0Mc1JrLkSsJVjvZ8NlTF_cleanshot-2023-11-02-at-1706522x.png?format=webp)
По умолчанию Пассворк сгенерирует самоподписанный сертификат. Когда установка завершена вы можете перейти к использованию полноценных SSL сертификатов.
- Для сертификатов, изданных доверенным издателем;
- Для сертификатов, выпущенных доменными центрами сертификации вашей организации.
Переименовать и поместить ваш SSL-сертификат или цепочку сертификации в ./conf/ssl
privkey.pem— приватный ключ,
fullchain.pem — сертификат\цепочка сертификации:
Вы можете настроить Let’s Encrypt, если у вас нет доменного центра сертификации (сертификата, выпущенного доверенным центром), но есть публичное DNS-имя сервера.
Отредактировать файл — .env изменить и дополнить следующие параметры:
Сохранить выполненные изменения и запустить контейнер
Проверить логи контейнера на получение сертификата
Пример выпуска сертификата
![Document image Document image](https://images.archbee.com/jvwmQL6VASLd-norgNd8V/ZoZT-rNspEbQohd2CQLT5_image.png?format=webp)
Пересоздать контейнеры для обновления данных с использованием новых сертификатов
Пассворк станет доступен по протоколу HTTPS с использованием сертификата от Let’s Encrypt.