Pre-upgrade checks
- Back up the database and the storage directories (or take a snapshot).
- Under System tools, confirm the data tables are complete and that no static entry is missing.
- 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.