Коробочная версия. Указания по установке

Чтобы установить коробочную версию Admin24 – Service Desk, вы должны пройти несколько этапов:

• Установку на сервер ОС
• Заполнение env. файла с параметрами
• Финальные настройки

admin24-vm-1.it5.su

admin24-vm-1-small.it5.su

поддомен для службы интеграции с Битрикс24; в .env указывается в параметре ADMIN24_DOMAIN.

В примере указаны домены, используемые при написании инструкции. При каждой конкретной установке домены будут свои.

Установка производится в чистой системе linux (Ubuntu Server 22\24, Alt Server 10\11, для других дистрибутивов при установке может потребоваться участие вендора). С обновленными пакетами приложений, предварительно установленным curl, docker и docker-compose.

Перед установкой в системе необходимо создать пользователя admin24, добавить его в группы docker и root. Под пользователем root создать каталог:

mkdir -p /var/www/admin24

chown -R admin24:admin24 /var/www/admin24

curl [ссылка на файл] --output install.sh

bash install.sh

После завершения процесса первичной установки, в директории /var/www/admin24 ,будет находится несколько файлов.
Потребуется заполнить env.example файл на основе указанных в нем комментариев, затем переименовать его в .env .

Файл docker-compose.yml.example просто переименовать в docker-compose.yml, настоятельно не рекомендуем самостоятельно вносить в него правки, как и в остальные файлы в директории /var/www/admin24 кроме .env, иначе в случае проблем с приложением для их решения наша служба поддержки потребует административный доступ к серверу.

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

Чтобы начать пользоваться приложением, необходимо настроить прокси-сервер с корректным доменом на работу по протоколу https на стандартном порте 443. Чтобы убедиться, что приложение установилось, необходимо сначала настроить прокси-сервер. Примеры конфигураций появятся в директории приложения: admin24-proxy.conf, admin24-proxy-settings.conf.

После заполнения .env и переименования .env и docker-compose.yml и настройки прокси следует повторно запустить.

bash install.sh

При повторном запуске установщик поднимет docker-контейнеры приложения автоматически.

Каждый раз после внесения правок в .env при запущеных docker-контейнерах приложения необходимо перезапускать контейнеры командами:

docker compose stop

docker compose up -d

bash retrieve-logs.sh

После выполнения команды, рядом с файлом retrieve-logs.sh появятся папка и архив с логами. При формировании обращения к разработчику прикладывайте этот архив.

После повторного запуска установщика подождите 5-10 минут, пока выполняется первичная инициализация проекта.

Примечание

Проверка почтового ящика не всегда срабатывает с первого раза. Если она не сработала, стоит повторно проверить почтовый ящик, кликнув по кнопке «Проверить».