Setup:Installation Guide/Docker/Docker Hub

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: halloweltPleaseChangeMe

                

Which services are runnning?

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

Manually updating the Docker image

BlueSpice 3.1.2 has no automatic upgrade feature.

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