Как установить Helpy Customer Helpdesk на Ubuntu 22.04

Helpy — это бесплатная и открытая платформа поддержки клиентов, написанная на языке Ruby on Rails. Она полностью открыта для модификации и может быть изменена в соответствии с лицензией MIT. Используется для создания автоматизированной системы обработки заявок и может быть интегрирована с сторонними приложениями. Она предлагает богатый набор функций, некоторые из которых перечислены ниже:

Поддержка многоканальной обработки заявок.
Имеет большую поддержку сообщества. Интегрирована с входящей электронной почтой через Sendgrid, Mandrill, Mailgun и др.
Полностью многоязычная и может предоставлять поддержку на нескольких языках.
Настраиваемая и соответствующая требованиям GDPR.
Удобна для мобильных устройств и работает на всех устройствах из коробки.

В этом посте мы покажем, как установить систему поддержки клиентов Helpy Helpdesk на Ubuntu 22.04.

Требования

Сервер с установленной Ubuntu 22.04.
Настроенный root-пароль на вашем сервере.

Обновление системы

Сначала вам нужно обновить и обновить все системные пакеты до последней версии. Вы можете обновить их все, выполнив следующую команду.

apt update -y  
apt upgrade -y

После обновления всех пакетов вам также нужно будет установить некоторые дополнительные зависимости на ваш сервер. Вы можете установить их все, выполнив следующую команду.

apt install apt-transport-https ca-certificates curl software-properties-common git -y

После установки всех пакетов вы можете перейти к следующему шагу.

Установка Docker и Docker Compose

В этом посте мы установим Helpy с помощью Docker и Docker Compose. Поэтому оба пакета должны быть установлены на вашем сервере.

Сначала добавьте GPG-ключ и репозиторий Docker, используя следующую команду.

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | apt-key add -  
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

Затем обновите кэш репозитория с помощью следующей команды.

apt update -y

Затем вы можете установить как Docker, так и Docker Compose, используя следующую команду.

apt install docker-ce docker-compose -y

После успешной установки обоих пакетов запустите и активируйте службу Docker с помощью следующей команды.

systemctl start docker  
systemctl enable docker

Теперь проверьте версию Docker с помощью следующей команды.

docker -v

Вы получите следующий вывод.

Docker version 20.10.22, build 3a2c30b

Вы также можете увидеть версию Docker Compose с помощью следующей команды.

docker-compose version

Вы должны увидеть следующий вывод.

docker-compose version 1.29.2, build unknown
docker-py version: 5.0.3
CPython version: 3.10.4
OpenSSL version: OpenSSL 3.0.2 15 Mar 2022

Установка Helpy на Ubuntu 22.04

Сначала загрузите последнюю версию Helpy из репозитория GitHub, используя следующую команду.

git clone https://github.com/helpyio/helpy.git

После завершения загрузки перейдите в директорию helpy с помощью следующей команды.

cd helpy

Затем переименуйте файл окружения Helpy, используя следующую команду.

cp docker/.env.sample docker/.env

Далее постройте образ Docker для Helpy, используя следующую команду.

docker-compose build

Вы должны увидеть следующий вывод.

Building helpy
Sending build context to Docker daemon  134.4MB
Step 1/20 : FROM ruby:2.5
2.5: Pulling from library/ruby
0bc3020d05f1: Pull complete 
a110e5871660: Pull complete 
83d3c0fa203a: Pull complete 
a8fd09c11b02: Pull complete 
14feb89c4a52: Pull complete 
958d2475f181: Pull complete 
ba6c4f28fec1: Pull complete 
757d13b54b5e: Pull complete 
Digest: sha256:ecc3e4f5da13d881a415c9692bb52d2b85b090f38f4ad99ae94f932b3598444b
Status: Downloaded newer image for ruby:2.5
 ---> 27d049ce98db
Step 2/20 : ENV RAILS_ENV=production     HELPY_HOME=/helpy     HELPY_USER=helpyuser     HELPY_SLACK_INTEGRATION_ENABLED=true     BUNDLE_PATH=/opt/helpy-bundle

Вы можете проверить все образы Docker с помощью следующей команды.

docker images

Вы должны получить следующий вывод.

REPOSITORY    TAG       IMAGE ID       CREATED          SIZE
helpy_helpy   latest    9d59c3019f8f   32 seconds ago   1.91GB
ruby          2.5       27d049ce98db   18 months ago    843MB

Затем запустите контейнеры Helpy и Nginx с помощью следующей команды.

docker-compose up -d

Вы должны увидеть следующий вывод.

Creating network "helpy_front" with driver "bridge"
Creating network "helpy_back" with driver "bridge"
Creating volume "helpy_rails-assets" with local driver
Pulling frontend (nginx:1.15)...
1.15: Pulling from library/nginx
743f2d6c1f65: Pull complete
6bfc4ec4420a: Pull complete
688a776db95f: Pull complete
Digest: sha256:23b4dcdf0d34d4a129755fc6f52e1c6e23bb34ea011b315d87e193033bcd1b68
Status: Downloaded newer image for nginx:1.15
Pulling postgres (postgres:9.4)...
9.4: Pulling from library/postgres
619014d83c02: Pull complete
7ec0fe6664f6: Pull complete
9ca7ba8f7764: Pull complete
9e1155d037e2: Pull complete
febcfb7f8870: Pull complete
8c78c79412b5: Pull complete
5a35744405c5: Pull complete
27717922e067: Pull complete
36f0c5255550: Pull complete
dbf0a396f422: Pull complete
ec4c06ea33e5: Pull complete
e8dd33eba6d1: Pull complete
51c81b3b2c20: Pull complete
2a03dd76f5d7: Pull complete
Digest: sha256:42a7a6a647a602efa9592edd1f56359800d079b93fa52c5d92244c58ac4a2ab9
Status: Downloaded newer image for postgres:9.4
Creating nginx            ... done
Creating helpy_postgres_1 ... done
Creating helpy_helpy_1    ... done

Затем проверьте статус всех запущенных контейнеров с помощью следующей команды.

docker-compose ps

Вы должны увидеть все запущенные контейнеры в следующем выводе.

      Name                    Command               State                                   Ports                                 
----------------------------------------------------------------------------------------------------------------------------------
helpy_helpy_1      /bin/bash /helpy/docker/run.sh   Up      0.0.0.0:3000->3000/tcp,:::3000->3000/tcp                              
helpy_postgres_1   docker-entrypoint.sh postgres    Up      5432/tcp                                                               
nginx              nginx -g daemon off;             Up      0.0.0.0:443->443/tcp,:::443->443/tcp, 0.0.0.0:80->80/tcp,:::80->80/tcp

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

На этом этапе Helpy установлен и работает на вашей системе. Теперь вы можете перейти к следующему шагу.

Доступ к веб-интерфейсу Helpy

Теперь откройте ваш веб-браузер и получите доступ к веб-интерфейсу Helpy, используя URL http://your-server-ip. Вы должны увидеть страницу приветствия Helpy.

Нажмите на Давайте настроим ваш Helpy. Вы должны увидеть страницу настройки учетной записи администратора.

Укажите ваш адрес электронной почты, полное имя, компанию и пароль, затем нажмите кнопку Сохранить изменения. Вы должны увидеть страницу настройки Helpy.

Нажмите на кнопку Пропустить на данный момент. Вы должны увидеть страницу конфигурации SMTP.

Нажмите на кнопку Пропустить на данный момент. Вы должны увидеть следующую страницу.

Теперь нажмите на кнопку Начать! Вы должны увидеть панель управления Helpy на следующей странице.

Нажмите на кнопку Пользователи. Вы должны увидеть следующую страницу.

Нажмите на кнопку Создать нового пользователя. Вы должны увидеть следующую страницу.

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

Вы также можете нажать на кнопку Отчеты, чтобы увидеть ваши отчеты по заявкам на следующей странице.

Заключение

Поздравляем! Вы успешно установили Helpy Customer Helpdesk на Ubuntu 22.04. Теперь вы можете использовать Helpy в вашей организации для ответов на вопросы клиентов из центрального места. Не стесняйтесь задавать мне вопросы, если у вас есть какие-либо.

Требования

Обновление системы

Установка Docker и Docker Compose

Установка Helpy на Ubuntu 22.04

Доступ к веб-интерфейсу Helpy

Заключение

Get new posts in your inbox