# Установка и настройка Help-Desk системы “UVdesk”.
**Шаг 1: обновите и установите необходимые инструменты.**
Для начала необходимо проверить виртуальную машину на наличие обновлений и установить необходимые инстументы.

sudo apt update && sudo apt upgrade
sudo apt install wget vim git unzip curl apache2 libapache2-mod-fcgid -y

Для настройки FastCGI требуется несколько модулей, и нам нужно их включить. Это можно сделать, выполнив эту команду:

sudo a2enmod actions fcgid alias proxy_fcgi rewrite
sudo systemctl restart apache2

**Шаг 2: Установка и настройка базы данных.**
Для последующей настройки будет использоваться MariaDB. Вот мой гайд по установке и настройке https://hackmd.io/@MihailProhorkin/HJ9PDmbRs

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

mysql -u root -p
CREATE DATABASE uvdeskdb;
CREATE USER 'uvdeskadmin'@'localhost' IDENTIFIED BY 'StrongPassword';
GRANT ALL PRIVILEGES ON uvdeskadmin.* TO 'uvdeskadmin'@'localhost';
FLUSH PRIVILEGES;
exit;

**Шаг 3: Установите и настройте PHP.**
Чтобы обслуживать страницы UVdesk, должен быть веб-сервер. Мы будем использовать Apache для этого руководства. Кроме того, для UVdesk требуется PHP, нам также нужно будет его настроить.

Установите php-fpm и зависимости

sudo apt update
sudo apt install -y php
sudo apt install php-{cli,fpm,json,common,mysql,zip,gd,mbstring,curl,xml,bcmath,imap,intl,mailparse} php-pear

Проверьте, запущен ли php-fpm.

systemctl status php*-fpm.service

**Шаг 4: Добавьте рекомендуемые настройки PHP**
Откройте свой файл php-fpm ini и добавьте / отредактируйте сведения, показанные ниже. Они включают настройки часового пояса и ограничения памяти. Добавьте свою дату.часовой пояс и измените memory_limit на 512 МБ.

sudo nano /etc/php/*/fpm/php.ini
memory_limit = 512M

[Date]
date.timezone = Europe/Moscow

Затем перезапустите php-fpm

sudo systemctl restart php*-fpm.service

**Шаг 5: Загрузка UVdesk**

wget "https://cdn.uvdesk.com/uvdesk/downloads/opensource/uvdesk-community-current-stable.zip"

Извлеките файл

unzip uvdesk-community-current-stable.zip

**Шаг 6: Установка UVdesk**
Переместите загруженный каталог в **/var/www/uvdesk**:

sudo mv uvdesk-community-*/  /var/www/uvdesk

Установите права доступа к каталогу на www-данные пользователя и группы:

sudo chown -R www-data:www-data /var/www/uvdesk
sudo chmod -R 775 /var/www/uvdesk

**Шаг 7: Настройте Apache для UVdesk**
Мы должны внести несколько изменений в настройки конфигурации Apache по умолчанию, добавив необходимые нам сведения для UVdesk. Перейдите в режим с поддержкой сайтов, создайте резервную копию файла по умолчанию и создайте новый с новыми конфигурациями.

sudo mv /etc/apache2/sites-enabled/000-default.conf{,.bak}

Создайте новый файл и добавьте сведения, показанные ниже.

<VirtualHost *:80>
    ServerName prohorkin.mihail.com
    ServerAlias www.prohorkin.mihail.com
    DocumentRoot /var/www/uvdesk/public/

    <Directory /var/www/uvdesk/public>
        Options -Indexes +FollowSymLinks +MultiViews
        AllowOverride All
        Require all granted
    </Directory>

    <FilesMatch \.php$>
        # 2.4.10+ can proxy to unix socket
        SetHandler "proxy:unix:/var/run/php/php7.4-fpm.sock|fcgi://localhost"
    </FilesMatch>

    ErrorLog /var/log/apache2/uvdesk-error.log
    CustomLog /var/log/apache2/uvdesk-access.log combined
</VirtualHost>

Измените разрешения для корневого каталога и перезапустите веб-сервер

sudo chown -R www-data:www-data /var/www/uvdesk
sudo chmod -R 755 /var/www/uvdesk
sudo systemctl restart apache2

Разрешить порт 8080 в вашем брандмауэре.

sudo ufw allow 80/tcp

Откройте браузер и укажите IP или полное доменное имя вашего сервера. http://udesk.example.com Вы должны увидеть страницу, как показано ниже. Нажмите "Начнем".

На следующей странице UVdesk проверит, соответствуете ли вы всем требованиям, необходимым для его запуска. Если все в порядке, нажмите "Продолжить".

Далее вам нужно будет добавить сведения о базе данных, которые мы создали на шаге 3, как показано ниже.

* Имя базы данных: uvdeskdb
* Имя пользователя базы данных: uvdeskadmin
* Пароль БД: StrongPassword
Как только вы закончите, нажмите “Продолжить“

На следующей странице представлена форма для добавления учетной записи super admin в систему. Введите информацию, затем нажмите “Продолжить“

Указываем префиксы для пользователей.

Далее вам остается только установить UVdesk. Нажмите “Установить сейчас”, чтобы начать работу.

После завершения установки UDdesk предоставит вам две ссылки: Admin и Frontend. Вы можете нажать на любой из них и проверить их.

Нажатие на ссылку “Панель администратора” приведет вас к форме входа. Введите созданные нами учетные данные администратора и войдите в систему.

Затем вам будет представлена панель мониторинга, как показано ниже.

Спасибо за прочтение данной статьи.