Коробочная версия.
Указания по установке
Указания по установке
Чтобы установить коробочную версию Admin24 – Service Desk, вы должны пройти несколько этапов:
Установка на сервер ОС
admin24-vm-1.it5.suadmin24-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 создать каталог:
В примере указаны домены, используемые при написании инструкции. При каждой конкретной установке домены будут свои.
Установка производится в чистой системе linux (Ubuntu Server 22\24, Alt Server 10\11, для других дистрибутивов при установке может потребоваться участие вендора). С обновленными пакетами приложений, предварительно установленным curl, docker и docker-compose.
Перед установкой в системе необходимо создать пользователя admin24, добавить его в группы docker и root. Под пользователем root создать каталог:
mkdir -p /var/www/admin24Сменить владельца на admin24:
chown -R admin24:admin24 /var/www/admin24
И перейти в эту директорию, авторизовавшись под пользователем admin24.
Далее следует получить от менеджера ссылку и скачать установочный файл (ссылка работоспособна в течение трех суток после получения):
Далее следует получить от менеджера ссылку и скачать установочный файл (ссылка работоспособна в течение трех суток после получения):
curl [ссылка на файл] --output install.sh
Запустить установщик:
bash install.sh
Заполнение env. файла с параметрами
После завершения процесса первичной установки, в директории /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 и настройки прокси следует повторно запустить.
Потребуется заполнить 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-контейнерах приложения необходимо перезапускать контейнеры командами:
Каждый раз после внесения правок в .env при запущеных docker-контейнерах приложения необходимо перезапускать контейнеры командами:
docker compose stop
docker compose up -d
Скрипт retrieve-logs.sh предназначен для сбора логов чтобы получить архив с логами, необходимо из папки приложения выполнить команду.
bash retrieve-logs.shПосле выполнения команды, рядом с файлом retrieve-logs.sh появятся папка и архив с логами. При формировании обращения к разработчику прикладывайте этот архив.
После повторного запуска установщика подождите 5-10 минут, пока выполняется первичная инициализация проекта.
После повторного запуска установщика подождите 5-10 минут, пока выполняется первичная инициализация проекта.
Финальная настройка
После этого, по основному адресу приложения откроется первая страница мастера первоначальной настройки:
Выберите язык и нажмите «Далее». Откроется страница проверки конфигурации. Если все данные в файле .env указаны корректно, внизу страницы появится кнопка «Перейти к регистрации», которая ведет на стандартную страницу регистрации в Admin24.
Примечание
Проверка почтового ящика не всегда срабатывает с первого раза. Если она не сработала, стоит повторно проверить почтовый ящик, кликнув по кнопке «Проверить».
Что делать, если возникли сложности?
Позвоните нам по телефону: 8 (800) 333-66-24, напишите на электронную почту: admin24@infoservice.ru или в Telegram. Принимаем звонки в любое время с 09:30 до 18:00 с понедельника по пятницу.
Мы поможем и расскажем, как настроить Admin24 под ваши нужды.
Мы поможем и расскажем, как настроить Admin24 под ваши нужды.