The following migration guides will additionally be available for each new version release (except maintenance releases):
- Admin Migration Guide
- Theme Migration Guide (If you are using your own theme.)
- Module Migration Guide (If you are using custom developed modules.)
Please follow these guides - if necessary - before you start the update process.
We also recommend to create a complete backup before each update (also for maintenance updates).
The HumHub Updater Module enables updates of your HumHub platform in just a few clicks and without any technical knowledge.
Installation of the
- Open your HumHub installation as Administrator
- Go to: Administration -> Modules -> Browse online
- Choose HumHub Updater and click 'Install'
- Switch to 'Installed' Tab
- Choose HumHub Updater and click 'Enable'
In the configuration of the module you can select the release channel for the available updates. This is set to "Stable" by default. Use the "Beta" channel here to try out new versions or verify compatibility with your own modules/themes.
Perform a update
- Select in left navigation: Administration -> Update HumHub
- Follow the updater steps
The update packages we provide typically contain only one update step (e.g. 1.4.0 to 1.4.1). This means you have to re-run the update procedure as many times as you have reached the latest HumHub version. During these procedure, especially between major updates (e.g. 1.3 -> 1.4.) all installed marketplace modules should be also updated.
Keep your updater module itself up to date, otherwise new versions may not be available for you.
The example commands presented here are based on the Server Setup described here.
We do not recommend skipping major versions. For example, an update from e.g. 1.3 to 1.5 should be done in two steps (1.3 to 1.4 and 1.4 to 1.5).
Stop the webserver and the cron jobs
Backup & Delete your current HumHub installation
Download and Extract
Download the latest HumHub package from https://www.humhub.com/download and extract the package to your
Restore individual files
Restore the following files from backup:
This step is only necessary if an external cache such as Redis is used.
Update installed modules
If you did not run the previous steps as the actual HumHub system user (e.g. www-data), you may need to correct the permissions.
Cleanup backup (optional)
Git based Installations
If you're running an installation based on our git repository (not recommended for production installations), you can find more information about updates in our developer documentation.