A ready-to-use Docker image for HumHub – the flexible open-source social networking platform.
This image provides everything you need to run HumHub in a modern, containerized environment.
Important:
This is still work in progress. Please try out our nightly builds. If you are planning to use it in a production environment, please be patient until stable releases for each version are available.
- Complete HumHub stack – preconfigured and production-ready
- Includes cron, queue workers and push events out of the box
- Secure defaults with automatic HTTPS certificates
- Simple setup with Docker Compose or any container platform
- Works with internal or external databases, Redis, or mail services
- Easy upgrading and version switching
Create a project directory (for example /opt/humhub) and inside it a docker-compose.yml file with the following content:
mkdir -p /opt/humhub
cd /opt/humhubservices:
humhub:
image: humhub/humhub:stable-nightly
restart: unless-stopped
ports:
- "80:80"
- "443:443"
- "443:443/udp" # HTTP/3 (optional)
depends_on:
db:
condition: service_healthy
volumes:
- ./humhub-data:/data
environment:
- HUMHUB_DEBUG=true
- SERVER_NAME=https://humhub.example.com
- HUMHUB_CONFIG__COMPONENTS__DB__DSN=mysql:host=db;dbname=humhub
- HUMHUB_CONFIG__COMPONENTS__DB__USERNAME=root
- HUMHUB_CONFIG__COMPONENTS__DB__PASSWORD=changeMe
db:
image: mariadb
restart: unless-stopped
command:
- --character-set-server=utf8mb4
- --collation-server=utf8mb4_unicode_ci
user: root
volumes:
- ./mysql-data:/var/lib/mysql
environment:
- MYSQL_ROOT_PASSWORD=changeMe
expose:
- "3306"
healthcheck:
test: ["CMD", "/usr/local/bin/healthcheck.sh", "--su-mysql", "--connect", "--innodb_initialized"]
interval: 10s
timeout: 5s
retries: 5Important:
Before starting the containers, make sure to adjust all environment variables in the example — especially passwords and domain names.
Never use the provided example values in production environments.Required changes include:
HUMHUB_CONFIG__COMPONENTS__DB__PASSWORDMYSQL_ROOT_PASSWORDSERVER_NAME
Once adjusted, start HumHub with:
docker compose up -dRequires Docker ≥ 20.10.13 with Compose v2.
If you are using an older setup, use docker-compose instead.
Your instance installer will be available at:
https://humhub.example.com