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

18min
Установка Docker
Скачать и установить Docker версии 18.06.0 или выше. Официальная статья об установке.﻿
Установить и включить плагин Docker Compose. Официальная статья об установке.﻿
Установка Docker и Docker Compose на Red OS, Astra Linux и других отечественных диcтрибутивах может отличаться от официальных инструкций для Docker и Docker Compose
Мы рекомендуем использовать Docker, установленный не через snap
Подготовка окружения для офлайн-установки
Если сервер имеет 2-4 ГБ ОЗУ, то мы рекомендуем включить SWAP-файл, так как сборка резервирует память для tmpfs и opcache.
﻿Создание SWAP файла на Linux﻿﻿
Для установки Пассворка необходимо скачать файлы и скрипт.
Создать директорию и перейти в неё:
Shell
mkdir your_directory
cd your_directory
mkdir your_directory
cd your_directory
﻿
Получить следующие компоненты:
﻿Релиз кандидат версию Пассворка﻿
Скопировать номер сертификата из клиентского портала Пассворка и в веб-браузере получить релиз-кандидат версию — https://portal.passwork.ru/api/download?rc=yes&apikey=номер_сертификата﻿
﻿Скрипт установки Пассворка
﻿Архив с файлами сборки Docker Compose
Образ контейнера Nginx 
Образ контейнера Percona Server for MongoDB﻿
Образ контейнера PHP﻿
Образ контейнера Postfix﻿
Образ контейнера Alpine﻿
Переместить скачанные файлы на Linux сервер в ту директорию, где планируется установка Пассворкав
В созданной директории создать поддиректорию passwork_images
Shell
mkdir your_directory/passwork_images
mkdir your_directory/passwork_images
﻿
Переместить *.tar образы в passwork_images
Shell
cd your_directory
mv *.tar ./passwork_images
cd your_directory
mv *.tar ./passwork_images
﻿
Структура файлов и папок после выполнения описанных действий должна быть следующей:
Shell
├── Passwork-xxxxxxxx.zip
├── passwork_compose_install.sh
├── passwork_compose_last.tar.gz
└── passwork_images
    ├── alpine.tar
    ├── nginx.tar
    ├── php8.3.tar
    ├── postfix.tar
    └── psmdb6.tar
├── Passwork-xxxxxxxx.zip
├── passwork_compose_install.sh
├── passwork_compose_last.tar.gz
└── passwork_images
    ├── alpine.tar
    ├── nginx.tar
    ├── php8.3.tar
    ├── postfix.tar
    └── psmdb6.tar
﻿
Проверка прав пользователя
Если вы выполняете установку не от имени root — необходимо убедиться, что пользователь состоит в группе docker.
Проверить можно следующим способом:
Shell
id $USER | grep docker
id $USER | grep docker
﻿
Добавить пользователя в группу docker можно так:
Shell
sudo usermod -a -G docker $USER
sudo usermod -a -G docker $USER
﻿
Запуск скрипта офлайн-установки
Предоставьте скрипту права на исполнение:
Shell
chmod +x ./*.sh
chmod +x ./*.sh
﻿
В директории your_directory запустите скрипт установки passwork_compose_install.sh с флагом -o
Shell
./passwork_compose_install.sh -o
./passwork_compose_install.sh -o
﻿
После установки скрипт автоматически выполнит команду docker ps. Пожалуйста, проверьте список запущенных контейнеров. Если контейнеры не были запущены, проверьте вывод и лог установки. Пример корректного вывода:
﻿
Мастер установки
После сборки и запуска контейнеров Пассворк будет доступен по адресу https://your_servername
По умолчанию Пассворк использует самоподписанный сертификат, который автоматически генерируется при установке, поэтому вы можете увидеть сообщение о том, что браузер не доверяет сертификату сайта
Выберите язык
Сначала система предложит выбрать язык интерфейса:
﻿
Чек-лист настроек сервера
Чек-лист параметров покажет все ли компоненты установлены на вашем сервере:
﻿
Подключение к базе данных
Для подключения нужно использовать адрес MongoDB по умолчанию:
﻿
Настройка Пассворка
Пассворк сгенерирует новый ключ для серверного шифрования. Если вы подключаете Пассворк к существующей базе данных, то укажите имеющийся ключ шифрования:
Не вводите ключ, который был сгенерирован не в Пассворке. Использование ключей, сгенерированных сторонними средствами, может привести к некорректной работе.
﻿
Лицензионный ключ
Лицензионные ключи можно скачать в вашем клиентском портале Пассворка или запросить у менеджеров:
﻿
Опциональные шаги после установки
После завершения работы скрипта, проверьте работоспособность новой установки.
Для добавления корневых сертификатов почтового сервера или 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
﻿
Онлайн-установка
Windows Server