Downgrading
Roll back to an older Arcane version without losing data.
Arcane migrates its database on upgrade. An older version refuses to start unless you allow a downgrade.
Downgrade Arcane
Section titled “Downgrade Arcane”- Back up the Arcane database.
- Set
ARCANE_ALLOW_DOWNGRADE=truein the Arcane container’s environment. - Start the older version. Arcane rolls the database back.
- Once Arcane starts cleanly, remove
ARCANE_ALLOW_DOWNGRADEor set it tofalse.
Recover if the downgrade is refused
Section titled “Recover if the downgrade is refused”An older release only rolls back migrations it knows about. If the log says rollback migrations are unavailable:
- Restore your pre-upgrade backup.
- Start the older version.
Downgrade from 3.0 to 2.x
Section titled “Downgrade from 3.0 to 2.x”3.0 can’t roll back below its v2.17.1 database baseline.
- Restore the backup you took before upgrading to 3.0.
- Start 2.17.1.