Installing BlueSpice free with Docker

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[edit | edit source]

Basic usage[edit | edit source]

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[edit | edit source]

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

Setting BlueSpice language and URL[edit | edit source]

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

Activating SSL[edit | edit source]

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)
  • (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=" bluespice/bluespice-free

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

Login to BlueSpice[edit | edit source]

username: WikiSysop
password: PleaseChangeMe

Which services are runnning?[edit | edit source]

  • Apache
  • Jetty9
  • Elasticsearch
  • MySQL/MariaDB
  • Parsoid
  • crond
  • memcached