Install-Matrix разделяет версию установщика и версии развёрнутых компонентов. Активные версии находятся в /root/matrix-server/.env.
IMAGE_POLICY=managedприupdateприменяет версии образов из текущего установщика.IMAGE_POLICY=customсохраняет все ссылки на образы из.env.
- Прочитайте CHANGELOG.ru.md и upstream-инструкции по миграции.
- Скачайте установщик из релиза и проверьте
SHA256SUMS. - Выполните:
sudo ./install-matrix.sh updateКоманда создаёт backup БД и конфигурации, сохраняет старый набор образов в .last-update.env, генерирует новый стек, загружает образы и запускает диагностику. При ошибке загрузки, запуска или health checks предыдущие образы возвращаются автоматически.
sudo ./install-matrix.sh rollbackКоманда возвращает предыдущие ссылки на образы, но не отменяет необратимые миграции БД. Для отката базы восстановите показанный командой pre-update backup:
sudo ./install-matrix.sh restore /root/matrix-server/data/backups/<timestamp>Установите IMAGE_POLICY=custom, измените защищённый .env и запустите update. Для production используйте неизменяемые digest:
SYNAPSE_IMAGE=ghcr.io/element-hq/synapse@sha256:...Крупные обновления Synapse, PostgreSQL и MAS сначала проверяйте на staging. Для major-обновления PostgreSQL требуется явный dump/restore или pg_upgrade; одной смены тега контейнера недостаточно.
Версия из ./install-matrix.sh --version должна совпадать с тегом GitHub-релиза. Не обновляйте production-сервер из изменяемой ветки.