Перейти к основному содержимому

Обновление

Обычное обновление​

По умолчанию все компоненты берутся с тегом latest, поэтому обновление — это две команды:

docker compose pull
docker compose up -d

Если нужно зафиксировать конкретную версию, задайте её в .env — одна переменная на все компоненты:

# .env
XLADA_VERSION=1.1.7

Миграции базы применяются автоматически при старте контейнера панели.

Перед обновлением​

Сделайте дамп базы — это единственный надёжный способ откатиться:

docker exec xpanel-db pg_dump -U xpanel xpanel > backup-$(date +%F).sql

Сохраните и .env: значения APP_SECRET, POSTGRES_PASSWORD и домены должны пережить обновление без изменений.

Что нельзя делать​

  • docker compose down -v — флаг -v удаляет тома вместе с базой.
  • Менять APP_SECRET после первого запуска — сломается вход и TOTP.
  • Менять имена томов и сервисов — при обновлении compose создаст новые пустые тома, а данные останутся в старых.

Откат​

docker compose down
# верните прошлое значение XLADA_VERSION в .env
docker compose up -d
docker exec -i xpanel-db psql -U xpanel -d xpanel < backup-2026-01-01.sql
Внимание

Миграции не откатываются автоматически. Если новая версия уже применила миграции, восстановление дампа — единственный способ вернуть схему в прежнее состояние.

Посмотреть текущую версию​

Версия видна в подвале панели и в ответе API:

curl -s https://panel.example.com/api/system/health | head