Skip to main content

Migration Guide for Administrators

Besides the normal Humhub update, major version upgrades may also require changes to the server system or configuration files. For example, this could be a new PHP dependency or a changed setting in the configuration file.

In addition to this guide, you may also check the Theme Migration Guide or Development Migration Guide.


  • The minimum PHP Version is now 8.0
  • The search has been reworked and the search index is automatically rebuilt after the update. This can take some time depending on the size.
  • If you are using the Professional Edition - Solr Module, the configuration must be changed. See Module Configuration for details.


  • HumHub now employs JavaScript nonces for enhanced security, which may necessitate manual adjustments for inserted scripts, such as statistics codes, to ensure compatibility. Your custom statistic code may need to be modified under Administration -> Settings -> Advanced. If Javascript is being used in the Custom Pages module or Custom Modules, please refer to the respective documentation.


  • Make sure that you don't use any third-party auth clients in your configuration. Use available Modules instead! protected/humhub/modules/user/authclient/[Facebook,GitHub,Google,LinkedIn,Live,Twitter].php


  • The minimum PHP Version is now 7.4
  • The deprecated "Directory" module has now been removed. It must now also no longer be used in the custom configuration files.


  • The minimum PHP Version is now 7.3


  • Usernames are now validated more strictly and can only contain letters, numbers and the characters -_.@ by default. This behavior can be customized via the User Module variable validUsernameRegexp. New Value: /^[\p{L}\d_\-@\.]+$/iu - Old Value: /^[\p{L}\d_\-@#$%^&*\(\)\[\]\{\}+=<>:;,.?!|~"\'\\\\]+$/iu.

  • Default permissions for Spaces or User Profiles can now be defined easily in the administration area.

  • The minimum PHP Version is now 7.2


  • The Space description is now limited to 100 characters. For longer texts there is a new "About" field.

  • The file names of some automatically generated file variants (like the preview images) have changed. Therefore the "cache" for those file variants should be deleted after the upgrade. The variants will be created again automatically later.

php protected/yii file/delete-variants
return [
'modules' => [
'space' => [
'hideAboutPage' => true
  • New profile field types UserMemberSince and UserLastLogin can be added
  • New image scale options


No changes necessary.


Caching and .htaccess changes

Removed caching section from .htaccess file. See Documentation for more details.

Image Handling

  • ImageMagick "convert" command ad Administration -> Settings -> Advanced -> Files was removed

  • New recommended PHP extension (ImageMagicks or GraphicsMagick)

Site logo

Your uploaded logo is now automatically scaled to different dimensions depending on the specific position.

We recommend uploading a high resolution version of the used logo again. Administration -> Settings -> Appearance


Changed Language codes

Some language codes have changed. If you use any codes in configuration files or in manually overwritten translations, please check if they are affected.

Affected codes:

Old language codeNew language code

The notification target configuration changed from

'targets' => [ 
\humhub\modules\notification\targets\WebTarget::class => [
'class' => \humhub\modules\notification\targets\WebTarget::class
'renderer' => ['class' => \humhub\modules\notification\renderer\WebRenderer::class]


'targets' => [ 
\humhub\modules\notification\targets\WebTarget::class => [
'renderer' => ['class' => \humhub\modules\notification\renderer\WebRenderer::class]

Notification targets now can be overwritten or disabled e.g:

return [
'components' => [
'targets' => [
\humhub\modules\notification\targets\MailTarget::class => [
'active' => false
\humhub\modules\notification\targets\MobileTarget::class => [
'class' => '/my/own/target/MobileTarget'


NOTE: This guide only affects updates from HumHub 1.2.x or lower to HumHub 1.3

1.) Please check following guides if you're using custom modules or themes:

2.) This release changes the existing cron jobs. Please see the chapter Installation: Configuration for the new cronjob configuration!

3.) If you're using the sources directly from GitHub, you need to build the required assets manually. Please see the chapter Development Environment for more details.


No changes required.


No changes required.


No changes required.


NOTE: This guide only affects updates from HumHub 0.11.2 or lower to HumHub 0.20

  1. Before you run an update please check, if your installed modules and themes are compatible with your targeted version. If not, you can follow the Theme Migration Guide and Module Migration Guide to make everything ready for the new version.

  2. Backup your data:

    • Backup the whole HumHub installation folder from your webroot
    • Make a complete MySQL-Dump from your HumHub database

Migration Steps

  1. Delete your current HumHub installation (Don't forget to make a backup as mentioned above, you will need these files later!)
  2. Download the latest HumHub package directly from and extract it to your webroot or install it via GitHub/Composer.
  3. IMPORTANT: Before starting the Web installer you have to restore the /uploads/ directory form your backup to your new installation
  4. Start the Web installer (e.g. http://localhost/humhub) and follow the instructions. If you enter the database name from your previous installation, HumHub will automatically migrate your existing database to the new version
  5. Reinstall all previously installed modules/themes (Make sure to use a 0.20 compatible version!)
  6. Rebuild the Search Index
php yii search/rebuild