Upgrading and rolling back

Pre-upgrade checks, rolling upgrade steps and how to roll back.

Pre-upgrade checks

  1. Back up the database and the storage directories (or take a snapshot).
  2. Under System tools, confirm the data tables are complete and that no static entry is missing.
  3. Note the current version number so you can compare after a rollback.

Upgrade steps

# 1. Stop writes (enter maintenance mode)
Admin → Site settings → Runtime → Maintenance mode: on

# 2. Replace the program files (keep config/ runtime/ uploads/)
unzip selfhub-1.x.zip -d /www/wwwroot/your-domain

# 3. Run the database migration
Admin → System tools → Check database tables / Rebuild static entries

# 4. Leave maintenance mode and spot-check key pages

Rollback

  • Restore the program files from the previous release archive
  • If the data structure changed, restore the pre-upgrade database backup
  • Clients need no reinstall; the server version is backwards compatible
Run the upgrade during a quiet period and tell the departments concerned in advance.
Copy a link to this page