BlueSpice free is an entry-level, no-cost version of BlueSpice pro. It sits on top of an existing MediaWiki without interfering with its architecture, adds lots of user-friendly features and supplements it with a multitude of helpful functions for teams and small businesses.
Report bug
·
Request feature
·
Learn more
This docker-bluespice-free is currently based on BlueSpice 4
cp ./example.env ./.env
export $(grep -v '^#' ./.env | xargs)
docker build -t $IMAGE_NAME:$IMAGE_TAG --build-arg HTTP_PORT=$HTTP_PORT --build-arg HTTPS_PORT=$HTTPS_PORT .
Note: If the data folder is inside the project dir, then also add this path in the .dockerignore
docker run \
--env-file ./.env \
-p $HTTP_PORT:$HTTP_PORT \
-p $HTTPS_PORT:$HTTPS_PORT \
-v $WIKI_INSTALL_DIR:/data \
-d $IMAGE_NAME:$IMAGE_TAG \
bluespice-free
cd docker-bluespice-free
make run
.env
file (optional)./bluespice -bs
BS_URL
.BS_USER
and password as BS_PASSWORD
to login.(NOTE: Currently HTTP_PORT only works with port 80, changing it to will cause internal nginx redirection issues) |
name | default value | description |
---|---|---|---|
BS_LANG |
en | bluespice language | |
BS_URL |
http://localhost | url on which bluespice will be served | |
BS_USER |
WikiSysop | admin username | |
BS_NAME |
Bluespice | default wiki name | |
BS_PASSWORD |
PleaseChangeMe | admin password | |
BS_DB_PASSWORD |
ThisIsDBPassword | default database password | |
HTTP_PORT |
80 | server http port | |
HTTPS_PORT |
443 | server https port | |
IMAGE_NAME |
bslocal/bsfree | docker image name to be created | |
IMAGE_TAG |
4.4.0 | docker image tag | |
DISABLE_PINGBACK |
no | sends pingback to the bluespice servers | |
WIKI_INSTALL_DIR 1 |
~/wiki | dir where bluespice files will be stored | |
WIKI_BACKUP_LIMIT 2 |
5 | max limit of backups, after this the oldest backup is deleted |
1: During first boot, a pingback is sent 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 by setting it yes
.
2: If WIKI_INSTALL_DIR
path is changed and if this directory is inside the current projcet folder (docker-bluespice-free/) then also add the path in .dockerignore and .gitignore.
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)After adding the certificates, also update the BS_URL
config to https
. Restart the bluespice container using ./bluespice --restart
or continue with Quick start.
usage: ./bluespice [-h] [-r] [-R] [-z] [-s] [-d] [-b] [-l]
options:
-h, --help show this help message and exit
-r, --restart restarts the wiki container
-R, --hard_restart removes the container, deletes the local image, rebuilds image and then start the container again.
-z, --stop stops the running wiki container
-s, --start starts the bluespice wiki container
-d, --clean_dangling cleans the docker of all the dangling images
-b, --build builds the bluespice wiki container
-l, --logs stream logs from current wiki installation
bluespice
cli