Протестированные OS:

  • Linux Ubuntu Server 18, 20, 22;
  • Astra Linux 1.7.0.

Для развертывания Chat Server необходимо подключение к сети Internet. Развертывание Chat Server в закрытом контуре описано в разделе «Установка Chat Server в закрытом контуре».

При установке на виртуальную машину возможны проблемы с контейнером Minio из-за отсутствия инструкций процессора AVX.

Инструкция по установке Chat Server на Astra Linux

При запуске на Astra Linux необходимо отключить блокировку интерпретаторов в МЦК выполнив команду sudo astra-interpreters-lock disable. После запуска блокировку можно вернуть, но, в случае падения сервера, он не сможет запустится автоматически. Рекомендуется добавить docker-контейнеры в исключения, либо по возможности не включать блокировку.

Для установки Chat Server на Astra Linux необходимо предварительно установить следующие пакеты:

Версия должна быть не ниже 20.10.2

Версия должна быть не ниже 1.29.2

apt install docker.io docker-compose

Следующие шаги установки не отличаются от указанных ниже в разделе «Инструкция по установке Chat Server на Linux Ubuntu Server».

Инструкция по установке Chat Server на Linux Ubuntu Server

Разворачивание docker-образа

Скачайте скрипт установки командой:

wget https://s3.eltex-co.ru/shared/elph-chat-server/ecss-elph-chat-server.sh

Выдайте права на исполнение:

chmod +x ecss-elph-chat-server.sh

Запустите скрипт, начнется загрузка:

./ecss-elph-chat-server.sh install


Если установка происходит удалённо по SSH, необходимо заново авторизоваться в терминале, так как пользователь был добавлен в группу docker, о чем будет получено уведомление:

Please, relogin in bash for access to docker group: 
$ su - user 
And repeat you command:

И повторить команду:

./ecss-elph-chat-server.sh install


В процессе установки будет необходимо авторизоваться во внешнем docker-регистре (данные авторизации вы можете уточнить в коммерческом отделе компании Eltex: eltex@eltex-co.ru):

Enter docker registry user: 
Enter docker registry password:

И ответить на вопросы, предназначенные для правильной базовой настройки конфигурации сервера:


Вопросы:Пояснение или пример ответа:

Enter your elph-proxy domain name or ip address. (Default: elph-proxy.loc):

Введите доменное имя или IP-адрес Elph Proxy, либо оставьте поле пустым для выбора значения по умолчанию. Например: elph-proxy.some-domain или 192.168.0.10

Enter your elph-chat-server domain name or ip address. (Default: elph-chat.loc):Введите доменное имя или IP-адрес Elph Chat Server, либо оставьте поле пустым для выбора значения по умолчанию. Например: elph-chat.some-domain или 192.168.0.12

Enter your ecss-core domain name or ip address. (Default: ecss-core.loc):

Введите доменное имя или IP-адрес ECSS Core, либо оставьте поле пустым для выбора значения по умолчанию. Например: ecss-core.some-domain или 192.168.0.13

Enter your ecss10 domain name. (Default: ecss_domain):

Введите домен ECSS-10, либо оставьте поле пустым для выбора значения по умолчанию. Например: eltex-domain

Do you use a multiple domains (y/n)?: 

Используете ли вы несколько доменов ECSS-10?
Данная настройка предназначена для выбора домена по умолчанию. 
При выборе n(no), будет использоваться один домен, заданный выше. При выборе y(yes), чат-сервер будет 
ожидать имя домена в авторизационных данных от клиента.

Enter your address-book-service domain name or ip address. (Default: address-book.loc): 

Введите доменное имя или IP-адрес сервиса адресной книги, либо оставьте поле пустым для выбора значения по умолчанию. Например: address-book-service.some-domain или 192.168.0.11

Enter your ecss-mysql domain name or ip address. (Default: ecss-mysql.loc):

Введите доменное имя или IP-адрес ECSS mysql, либо оставьте поле пустым для выбора значения по умолчанию. Например: ecss-mysql.some-domain или 192.168.0.14
Enter your user-status-service domain or ip address. (Default: user-status-service.loc):

Введите доменное имя или IP-адрес User Status Service, либо оставьте поле пустым для выбора значения по умолчанию. Например: user-status-service.some-domain или 192.168.0.15 

Do you want to change the support user's password? (y/n):

Хотите ли вы изменить стандартный пароль (password) для чата поддержки? (y/n)

Enter new support user's password:

Confirm new support user's password:

При выборе y в пункте выше, введите и подтвердите пароль.



В случае правильного ввода конфигурационных настроек Chat Server запустится автоматически. Об этом будет свидетельствовать следующее сообщение:

Successfully start Elph-chat-server latest in stable


Обязательный к изменению параметр: BEARER_TOKEN_PRIVATE_KEY — секретный ключ для генерации токена авторизации. По умолчанию стоит демонстрационное значение, которое важно поменять для обеспечения безопасности сервера. Значением может выступать любая комбинация символов >256 бит (примерно 32 символа). Значение данного параметра должно быть одинаковое в конфигурационном файле Chat Server и на сервисах: User Status Service, Call History Service и Address Book Service.

Изменение конфигурации

Перед изменением конфигурации сначала остановите Chat Server.

Для остановки Chat Server без очистки контейнеров и docker-network:

./ecss-elph-chat-server.sh stop

Для остановки Chat Server с очисткой контейнеров и docker-network:

./ecss-elph-chat-server.sh down


Обратите внимание! Начиная с версии 2.4.0 команда ./ecss-elph-chat-server.sh down очищает только контейнеры и docker-network. Для очистки базы данных необходимо удалить директорию volumes. Для этого используйте команду:

rm -r elph-chat-server/stable/volumes/


Изменить конфигурацию можно двумя способами:

  1.  Заново сконфигурировать при установке. Заново запустите скрипт с установкой:

    ./ecss-elph-chat-server.sh install


  2.  Изменить файл конфигурации вручную. Подробнее об этом в разделе «Версия 2.11.0. Настройка и управление Chat Server».

    Для этого остановите Chat Server:

    ./ecss-elph-chat-server.sh down

    Измените конфигурацию:

    <nano/vim/mcedit> elph-chat-server/stable/.env

    Запустите Chat Server командой:

    ./ecss-elph-chat-server.sh up