Installation Manual BlueSpice 2.27.3 Without Installer

From BlueSpice

< Setup:Installation Manual
Jump to: navigation, search

This document describes the steps for the installation of BlueSpice version 2.27.3 without the installer.

Tip for this Document

  • Please, read this manual completely and work through the single installtion steps one after another.
  • For editing the configuration files with a text editor, the files must be saved in UTF-8 coding without BOM (Byte Order Mark).
  • The placeholder <installpath-bluespice> stands for the path to your BlueSpice installation, e.g C:\inetpub\wwwroot\bluespice (Windows) or /var/www/bluespice (Linux).
  • The placeholder <bluespice-url> stands for the URL to your future BlueSpice installation, e.g. http://localhost/bluespice.


For the installation of BlueSpice, a completely installed and configured MediaWiki version 1.27.x is required. This must be accessible with a browser under <bluespice-url>. For further information, please take a look at the installation manual for MediaWiki.

Download BlueSpice

Download the current version of BlueSpice directly at Sourceforge. The package is named

If you purchased BlueSpice pro, this step is not neccessary. The appropriate package has been provided by the distributor.

Unzip and Copy BlueSpice

Unpack the downloaded archive with BlueSpice. Note that the relevant content is located in a subfolder (bspw. bluespice-free). Those contains the following files and directories:

Setup:Setup bluespice packagecontent.jpg
  • extensions
  • settings.d
  • skins
  • installcheck.php
  • LocalSettings.BlueSpice.php
  • nsfr_img_auth.php (nur BlueSpice pro)

Move this file to <installpath-bluespice> and integrate it in the already existing folder.

Renaming of Relevant Folders

Rename the following folders in <installpath-bluespice> as follows:

  • extensions/BlueSpiceFoundation/data.template
    --> extensions/BlueSpiceFoundation/data
  • extensions/BlueSpiceFoundation/config.template
    --> extensions/BlueSpiceFoundation/config

Adjusting File System Permissions

Make sure that the following folders in <installpath-bluespice> are accessible and writable by the webserver:

  • cache
  • images
  • extensions/BlueSpiceFoundation/data
  • extensions/BlueSpiceFoundation/config

Detailed information about the file system permissions can also be found in the security settings.

Checking the Installation Requirements

Call up the file installcheck.php at <bluespice-url> in your browser (example: http://localhost/installcheck.php).

Correct all red (error) and ideally yellow (warning) declared messages (mostly in the php.ini) like specified. Please note, that changes in the php.ini may require a restart of the webserver. Do not continue until you have been able to remove at least all errors (red). 

Setup:Setup bluespice installcheck.jpg

Integrating BlueSpice in MediaWiki

Now it's time to integrate BlueSpice into MediaWiki. To do this, open the file LocalSettings.php in the folder <installpath-bluespice> in an text editor and add the following at the end of the code:

require_once "$IP/LocalSettings.BlueSpice.php";

Save and exit the file.

Beginning with BlueSpice version 2.27.1, all default settings as well bitte single modules of BlueSpice are outsourced, so BlueSpice can be integrated into MediaWiki with only this one line. For more technical information about this also take a look at our documentation for advanced users.

Installation of BlueSpice

Open a command line and switch to the folder <installpath-bluespice>. Execute the follwoing command:

php maintenance/update.php (Linux)
php maintenance\update.php (Windows))
With Windows, please take care that the environment variables are set correctly to access the php command.

With Linux, please keep in mind that after running the update.php, the file system permissions need to be adjusted again.

When the script is finished with the "Done" message, proceed to the next step.

Setup:Setup bluespice maintenance update.jpg

If the script should stop during the process, restart it.

Check the Installation

Call <bluespice-url> in your browser. BlueSpice should now be successfully installed and a login with your access data should be possible.

Setup:Setup bluespice finished.jpg

Further configuration

Your BlueSpice installation is now ready to use. You can also do some further configuraiton:

Also, some security settings are recommended.