Installing BlueSpice free with Docker

Revision as of 12:40, 12 July 2022 by Margit Link-Rodrigue (talk | contribs) (Changed categories.)


The easiest way to run BlueSpice free is to install it with an all-in-one Docker image. All required services are preconfigured.

You can find all necessary information directly on Docker Hub.

How to use the Docker Hub image

Basic usage

Example for quick start. Blue Spice will be accessible only in localhost.

docker run -d -p 80:80 bluespice/bluespice-free

Keep your data outside of the docker

docker run -d -p 80:80 -v {/my/data/folder}:/data bluespice/bluespice-free

Setting BlueSpice language and URL

docker run -d -p 80:80 -v {/my/data/folder}:/data -e "bs_lang=en" -e "bs_url=http://www.domain.com" bluespice/bluespice-free

Activating SSL

Using SSL inside the Blue Spice docker image, the data directory should be outside of the docker. Create a folder named cert inside your data folder. Inside this folder, certificates must be named like:

  • ssl.cert (SSL certificate. mandatory)
  • ssl.key (Private key of ssl.cert. mandatory)
  • ssl.ca (3rd party CA certs for ssl.cert. optional) If everything is ready for the first run, just run the following command:
docker run -d -p 80:80 -p 443:443 -v {/my/data/folder}:/data -e "bs_lang=en" -e "bs_url=https://www.domain.com" bluespice/bluespice-free

Note: Port 443 includes the command and also $bs_url schema changed to https

Login to BlueSpice

username: WikiSysop
password: PleaseChangeMe

Which services are runnning?

  • Apache
  • PHP-FPM
  • Jetty9
  • Elasticsearch
  • MySQL/MariaDB
  • Parsoid
  • crond
  • memcached



To submit feedback about this documentation, visit our community forum.