Wikibase/Suite

Introduction
This document covers installing Wikibase manually. (For Docker installation instructions, look here.)

A Wikibase install often consists of the following elements:


 * An RDBMS (MariaDB/MySQL or SQLite) [required]
 * MediaWiki [required]
 * The Wikibase extension [required]
 * Other related extensions [optional]
 * The Wikidata query service (WDQS) [optional]
 * The WDQS proxy
 * The WDQS frontend
 * QuickStatements [optional]
 * Elasticsearch [optional]

The Docker install contains all these components and can be started with a single docker-compose command. This install meets the needs of many Wikibase users, especially those just starting out.

However, for those not wanting to run Docker (because of additional administrative overhead, scaling issues in production, or a desire to understand the components better), here's how to install each component manually.

Network configuration
Consult the network description and diagram here.

Before you dive in
There's a large amount of technical documentation to be read and enjoyed at the Wikibase technical doc site.

To successfully navigate this process, you should probably have:


 * Familiarity with Linux and web server software
 * One or more servers on which you have permissions to install software

Instructions
The MediaWiki install linked in the next step relies on a running RDBMS with a database and user already created.

We recommend using MariaDB, and though a full installation guide is outside of the scope of this document, start with this excellent collection of documentation and this tutorial.
 * Create a database
 * User account management

Instructions
Install instructions for MediaWiki

Working MediaWiki nginx config

Instructions
Installation guide for Wikibase

Installation guide for Composer

Optional sidebar
If you'd like to add some Wikibase-related links to your main page sidebar, you can add these configuration stanzas to your LocalSettings.php.

OAuth
Many parts of Wikibase rely on the OAuth extension, as you'll see below.

Installation
The OAuth install instructions are comprehensive. Note that you'll benefit from a working understanding of [Manual:User_rights|user rights] to finish this install.

Wikidata Query Service
The Wikidata Query Service (WDQS), which consists of the Blazegraph SPARQL query backend and its updater, can be and often is used in conjunction with Wikibase.

Instructions
While intrepid users may wish to compile their own instance of WDQS, we recommend using the precompiled version.


 * Download the desired version from Archiva.
 * 0.3.42 is the recommended version as of this writing, September 2020. However, expect this information to be updated with the impending MediaWiki release.
 * Consult the WDQS user manual.
 * In particular, configure RWstore.properties as noted here.
 * See also these WDQS Docker image configuration tips.

Instructions

 * Install Elasticsearch 6.5.4 using these install instructions.
 * This will prompt you to install OpenJDK.
 * Install the extensions CirrusSearch and Elastica on your MediaWiki instance.
 * Modify elasticsearch.yml as needed
 * Name your cluster with the cluster.name directive
 * Make a single-node cluster: "discovery.zen.minimum_master_nodes: 1"
 * Set network.host as needed
 * Modify jvm.options as needed (above all set "-Xms" and "-Xmx" based on the amount of memory available to your host)

Instructions

 * Download and install QuickStatements from Github.
 * Make changes to config.json as needed. Lines to change include:
 * publicMwOAuthUrl and MwOAuthUrl: set to your Wikibase instance's OAuth URL
 * api:
 * pageBase:
 * toolBase:

Reference

 * Wikibase Docker repo on GitHub
 * Docker install instructions