HumHub¶

HumHub is a free social network software and framework built to give you the tools to make teamwork easy and successful.

The software is based on top of the Yii framework and therefore written in PHP.

Note

For this guide you should be familiar with the basic concepts of

License¶

HumHub is released under a dual license, on one hand the AGPL V3 license and on the other hand a commercial license. The license and terms can be found on the Humhub website.

Prerequisites¶

We’re using PHP in the stable version 8.1:

[isabell@stardust ~]$ uberspace tools version show php
Using 'PHP' version: '8.1'
[isabell@stardust ~]$

You’ll need your MySQL credentials. Get them with my_print_defaults:

[isabell@stardust ~]$ my_print_defaults client
--default-character-set=utf8mb4
--user=isabell
--password=MySuperSecretPassword
[isabell@stardust ~]$

Your domain needs to be set up:

[isabell@stardust ~]$ uberspace web domain list
isabell.uber.space
[isabell@stardust ~]$

Installation¶

cd to your DocumentRoot and download the latest release, then unzip it into the html directory:

[isabell@stardust ~]$ cd /var/www/virtual/$USER/
[isabell@stardust isabell]$ wget --output-document=humhub.zip "https://www.humhub.com/download/package/humhub-1.12.2.zip"
[…]
[isabell@stardust isabell]$ unzip humhub.zip
[isabell@stardust isabell]$ cd humhub-1.12.2
[isabell@stardust humhub-1.12.2]$ mv * /var/www/virtual/$USER/html/
[isabell@stardust humhub-1.12.2]$

Database Setup¶

Humhub saves your data in a MySQL database. Please use an additional database. You need to create this database before you enter the database credentials in the web-installer.

[isabell@stardust ~]$ mysql -e "CREATE  DATABASE ${USER}_humhub"
[isabell@stardust ~]$

Configuration¶

Point your browser to your domain (e.g. isabell.uber.space) to set up and configure your HumHub installation. Check the documentation for further questions.

Updates¶

Check the news regularly to stay informed about the newest version. You will be additionally notified about available updates in the built in humhub update module. You can update the installation via the update module which can be found in the humhub administration menu.

Tested with HumHub 1.12.2, Uberspace 7.13, PHP 8.1

Written by: Christoph Reißig <https://reissig-stopp.de>