Installation Guide

Note:For general questions regarding the installation, maintenance, and usage of BlueSpice, go to our SourceForge help forum .

Introduction

We are happy that you decided to install the latest version of BlueSpice, our innovative and feature-packed wiki system. Carefully follow our step-by-step instructions, and BlueSpice will be up and running in no time!

After checking your system requirements and preparing your server environment, you will install the BlueSpice application and optionally tweak your configuration to improve your system performance so that your users can enjoy working with their new wiki.

Prerequesites

Before installing BlueSpice 3, review that you meet all system requirements and that your server environment is ready. If you need to set up a server environment first, we provide detailed instructions here:

1. Check the system requirements
2. Prepare your system for the BlueSpice installation.
   To set up your server environment, follow the step-by-step instructions or read our quick reference:
   • Linux
   • Windows

Installing BlueSpice 3

Please select which installation type you need:

• Full BlueSpice 3 installation with Installer
  • Extended Functions: VisualEditor, ExtendedSearch
• BlueSpice 3 WikiFarm installation
• Docker image

Upgrade and patch updates

• BlueSpice 3 upgrade from version 2.27.x to the current version of BlueSpice
• Patch Update from version 3.1.x to a higher version 3.1.x
• Upgrade from BlueSpice free 3.1.x to BlueSpice pro 3.1.x

Migration from MediaWiki to BlueSpice

• Migration from MediaWiki to BlueSpice

Quick reference: Configuration, services, and optimization

Warning:Pages in the namespaces SocialEntity and User are indexed by search engines by default until version 3.1.13. If you run a public wiki with an earlier version, you should exclude these namespaces from being searchable unless you want these pages to be indexed by public search engines.

If you don't need to set up a server environment "from scratch", you can directly refer to the setup instructions for individual system components. Just make sure that you really have everything configured as needed:

Services and system configuration

• Linux
  • Introduction
  • Apache und PHP
  • MariaDB
  • Jetty
  • Elasticsearch
  • Node.js
  • Parsoid
  • Python
  • Memcached
  • Texvc (BlueSpice pro only)
  • PhantomJS
• Windows
  • Introduction
  • IIS Web Server
  • Visual C++ Redistributable for Visual Studio 2015
  • PHP Manager
  • PHP 7.3
  • MariaDB
  • OpenJDK
  • Apache Tomcat
  • Elasticsearch
  • Git
  • Node.js
  • Parsoid
  • Python
  • PhantomJS (BlueSpice pro only)

Webservices for Apache Tomcat

• PDF-Export
• VisualDiff (BlueSpice pro only)
• LatexRenderer (BlueSpice pro only)

Additional settings and optimizations

• Caching
• Cronjobs
• Time Zone

Security settings

• File System Permissions
• Deactivating installcheck file
• Save Directories
  

Compendium

• Backup
• Configuration Folder settings.d
• ExtendedSearch Configuration
• Performance Optimization
• Performance Optimization/ManualRecache
• Performance Optimization/MySQL
• Performance Optimization/PHP
• Rebuilding the Search Index
• VisualEditor Configuration
• Windows Folder Structure