bluespice/bluespice-free repository overview

⁠How to use this image

⁠Introduction

This is an all in one image for BlueSpice. All required services are preconfigured.

⁠Basic usage

Example for quick start. BlueSpice 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 BlueSpice docker image, 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 first run, just run 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

⁠Run with default configuration

Create a .env file with the following key=value from given environment variables. Then run:

export $(grep -v '^#' ./.env | xargs) && docker run --env-file ./.env -p $HTTP_PORT:80 -p $HTTPS_PORT:443 -v $WIKI_INSTALL_DIR:/data -d $IMAGE_NAME:$IMAGE_TAG

⁠Environment variables

⁠Which services are running?

• Nginx
• PHP-FPM
• Jetty9
• Elasticsearch
• MySQL/MariaDB
• Parsoid
• Crond
• Memcached

⁠Pingback

At the first boot of the container, we are sending a pingback to our servers for collecting download statistics of the docker image. This pingback is not collecting any data of your container or your current installation. You can also easily disable this pingback with an environment variable. DISABLE_PINGBACK=yes

docker run -d -p 80:80 -e DISABLE_PINGBACK=yes ![Blue Spice Logo](https://bluespice.com/wp-content/uploads/2017/07/BlueSpice-logo_final-mediawiki-v2017.png)