Документация › Администрирование › Резервные копии и обновление
Резервные копии и обновление
Всё состояние Ezx Desk — это база PostgreSQL, каталог вложений и файл настроек. Копировать нужно все три.
Резервная копия
docker compose exec app ezxdesk backup --output /var/lib/ezxdesk/files/backup/
# база и настройки → ezxdesk-2026-09-02T0300.tar.zst
Каталог вложений команда не включает — копируйте ./data/files отдельно, например через
rsync или снимки диска. Пример ночного задания:
0 3 * * * cd /opt/ezxdesk && docker compose exec -T app ezxdesk backup --keep 14 \
&& rsync -a --delete data/files/ backup-host:/srv/ezxdesk-files/
Восстановление
- Остановите
appиworker, оставив работать базу. docker compose run --rm app ezxdesk restore ezxdesk-2026-09-02T0300.tar.zst- Верните каталог вложений и запустите службы.
Раз в квартал проверяйте восстановление на отдельном сервере: так вы узнаете, сколько оно
занимает, и заранее заметите ошибки в копиях.
Обновление
Внутри ветки 4.x обновление не требует остановки дольше минуты:
docker compose pull
docker compose up -d
docker compose exec app ezxdesk migrate
Миграции обратно совместимы в пределах ветки: при неудаче можно вернуть предыдущий образ без отката базы.
Переход с версии 3
- Файл
config.ymlзаменён наezxdesk.toml. Перенос:ezxdesk config convert config.yml. - Минимальная версия PostgreSQL — 14.
- API v1 работает до выхода 5.0, но новые поля появляются только в v2.
- Сначала обновитесь до 3.18 — более старые версии на 4.x не переносятся.