Ezx DeskДокументация v4.12.2
Документация › Начало работы › Установка

Установка

Рекомендуемый способ — 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 не уйдут.

Обновлено 28 октября 2026 · относится к версии 4.12