Installation Guide

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

Introduction

We are happy that you decided to install the latest version of BlueSpice 4.

Please follow these steps:

1. Check the system requirements
2. Prepare the server environment
3. Install the BlueSpice application
4. Optimize the configuration

Check the system requirements

• System requirements

Prepare the server environment

• Linux server environment
• Windows server environment

Install the BlueSpice application

Please select which installation type you need:

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

Upgrade and patch updates

• Patch update from BlueSpice 4.2.x to a higher version 4.2.x+n
• Upgrade from BlueSpice 3.2.x to BlueSpice 4.2.x

Migration from MediaWiki to BlueSpice

• Migration from MediaWiki to BlueSpice

Optimize the configuration

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:

Webservices for Apache Tomcat

• Drawio
• Mathoid
• PDF-Export

Additional settings and optimizations

• Caching
• Cronjobs
• Time Zone

Security settings

• File System Permissions
• Save Directories

Compendium

• Backup
• Configuration Folder settings.d
• ExtendedSearch Configuration
• Folder structure under Windows
• Maintenance scripts
• Maintenance scripts/batchStabilize
• Maintenance scripts/dumpPDF
• Maintenance scripts/executeTransfer
• Maintenance scripts/export
• Performance Optimization
• Performance Optimization/ManualRecache
• Performance Optimization/MySQL
• Performance Optimization/PHP
• Server configuration for CollabPads
• VisualEditor Configuration
• Windows Folder Structure

---

To submit feedback about this documentation, visit our community forum.