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[Bearbeiten | Quelltext bearbeiten]

Basic usage[Bearbeiten | Quelltext bearbeiten]

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[Bearbeiten | Quelltext bearbeiten]

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

Setting BlueSpice language and URL[Bearbeiten | Quelltext bearbeiten]

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[Bearbeiten | Quelltext bearbeiten]

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[Bearbeiten | Quelltext bearbeiten]

username: WikiSysop
password: PleaseChangeMe

Which services are runnning?[Bearbeiten | Quelltext bearbeiten]

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

Manually updating the Docker image[Bearbeiten | Quelltext bearbeiten]

BlueSpice 3.1.2 has no automatic upgrade feature.

See: Manual upgrade process and how to fix some known issues.



Feedback zur Dokumentation ist im Community-Forum möglich.