Установка
Рекомендуемый способ — Docker Compose. Пакеты для Debian и Ubuntu тоже доступны, но обновлять их придётся вручную.
Установка через Docker
Нужны Docker Engine 24 или новее и плагин Compose. Адрес реестра образов и токен для входа в него показаны в личном кабинете на странице лицензии. Войдите в реестр:
docker login <адрес реестра> -u <номер лицензии>
Создайте каталог и файл docker-compose.yml:
services:
db:
image: postgres:16
restart: unless-stopped
environment:
POSTGRES_DB: ezxdesk
POSTGRES_USER: ezxdesk
POSTGRES_PASSWORD: ${DB_PASSWORD}
volumes:
- ./data/db:/var/lib/postgresql/data
app:
image: ${EZX_REGISTRY}/ezxdesk/server:4.12
restart: unless-stopped
depends_on: [db]
env_file: .env
ports:
- "127.0.0.1:8080:8080"
volumes:
- ./data/files:/var/lib/ezxdesk/files
- ./ezxdesk.toml:/etc/ezxdesk/ezxdesk.toml:ro
worker:
image: ${EZX_REGISTRY}/ezxdesk/server:4.12
command: worker
restart: unless-stopped
depends_on: [db]
env_file: .env
volumes:
- ./data/files:/var/lib/ezxdesk/files
- ./ezxdesk.toml:/etc/ezxdesk/ezxdesk.toml:ro
Рядом положите .env с паролем базы и ключом приложения:
EZX_REGISTRY= # адрес реестра из личного кабинета
DB_PASSWORD=замените-на-длинный-пароль
EZX_SECRET_KEY= # 64 символа: openssl rand -hex 32
EZX_LICENSE_KEY= # можно оставить пустым — будет режим до 5 операторов
Минимальный ezxdesk.toml описан в разделе «Файл настроек». Запустите:
docker compose up -d
docker compose exec app ezxdesk migrate
docker compose exec app ezxdesk create-admin --email admin@example.com
Команда create-admin выведет временный пароль — смените его при первом входе.
Обратный прокси и HTTPS
Сервер слушает только 127.0.0.1:8080. Наружу его публикуют через nginx или Caddy. Пример для nginx:
server {
listen 443 ssl;
server_name desk.example.com;
client_max_body_size 50m;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location /ws/ {
proxy_pass http://127.0.0.1:8080;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
Без пути /ws/ список заявок не будет обновляться сам — придётся перезагружать страницу.
Пакеты для Debian и Ubuntu
Пакет .deb скачивается в личном кабинете вместе с файлом контрольной суммы. Установка:
sha256sum -c ezxdesk_4.12.2_amd64.deb.sha256
sudo apt install ./ezxdesk_4.12.2_amd64.deb
Пакет ставит службы ezxdesk и ezxdesk-worker, настройки лежат в /etc/ezxdesk/.
PostgreSQL устанавливается отдельно.
Проверка установки
curl -s http://127.0.0.1:8080/healthz
{"status":"ok","db":"ok","worker":"ok","version":"4.12.2"}
Если worker в ответе — "stale", фоновый обработчик не запущен: письма не будут забираться,
а напоминания по SLA не уйдут.