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

• В папке приложения находятся несколько файлов и папок. Необходимо настраивать только файл .env; остальные файлы настоятельно рекомендуем не изменять.

• Заполнить файл .env на основе указанных в нем комментариев.

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

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

• В файле docker-compose.yml напротив настоятельно не рекомендуется что-либо менять, иначе в случае проблем с приложением для их решения наша служба поддержки потребует административный доступ к серверу.

• Запустите докер-контейнеры:

После выполнения команды, рядом с файлом retrieve-logs.sh появятся папка и архив с логами. При формировании обращения к разработчику прикладывайте этот архив. Если Admin24 запускается в браузере, собрать логи можно через раздел «Поддержка» → «Логи» в web-интерфейсе.

• Каждый раз после внесения правок в .env-файл или в случае сбоев, перезапускайте контейнеры:

После получения внешнего IP необходимо пробросить порты 80 и 443 к серверу, на котором будет расположен прокси. Порядок проброса портов различается в зависимости от марки маршрутизатора, поэтому информацию о том, как это сделать, необходимо получить из документации на маршрутизатор.

В первую очередь необходимо привязать внешний IP-адрес к домену (создать в зоне DNS запись типа A). Чтобы это сделать, необходимо обратиться в службу поддержки регистратора, у которого регистрировался домен. Узнать, кто является регистратором вашего домена, можно у ответственного лица, зарегистрировавшего домен, в вашей компании.

После того, как вы получите внешний «белый» IP, привяжете его через DNS к домену и пробросите порты на маршрутизаторе, можно приступать к настройке прокси сервера.

Приведем пример настройки прокси-сервера на ОС Ubuntu 22 с помощью установочного скрипта. Предполагается, что приложение предварительно было установлено на этом же сервере. Если для прокси используется другой сервер, то установку и настройку необходимо проводить вручную, используя документацию на соответствующий сервер.

• Перейдите в папку приложения:

где admin24-vm.it5.su — домен, по которому будет работать приложение.

• В ходе работы скрипта укажите пароль для sudo:

• В скрипт встроена установка certbot. Установка certbot осуществляется в диалоговом режиме:

Шаг 1.
Укажите Email администратора:

Шаг 2.
Согласитесь с пользовательским соглашением на использование сертификатов certbot (введите Y):

Шаг 3.
Согласитесь со вторым пользовательским соглашением на использование certbot:

Шаг 4.
На следующем шаге certbot выведет список доменов, которые обслуживает nginx. Если приложение устанавливается на чистый сервер, в списке должен быть один домен, указанный при запуске скрипта install-proxy.sh. Для продолжения установки необходимо ввести цифру 1 (номер единственного домена в списке):

Шаг 5.
На этом шаге certbot выдаст сертификат и настроит nginx.

После этого, по основному адресу приложения откроется первая страница мастера первоначальной настройки:

Выберите язык и нажмите «Далее». Откроется страница проверки конфигурации. Если все данные в файле .env указаны корректно, внизу страницы появится кнопка «Перейти к регистрации», которая ведет на стандартную страницу регистрации в Admin24.