Wikibase/Installation

This page provides a step-by-step instruction how to install a basic version of Wikibase. It just explains the minimal configuration needed for Wikibase. If you're interested in a more advanced configuration, please refer to the advanced configuration guide.

=Prerequisites=

MediaWiki
Technically, Wikibase is an extension (actually two extensions) to MediaWiki, so you need to set up MediaWiki first.

Composer
The easiest way to install all all dependencies of Wikibase is using Composer. Here you can find installation instructions for Composer.

=Installation= A basic installation of Wikibase is pretty much straight forward and basically consists of 4 steps: The following guide will lead you through these steps.
 * 1) getting Wikibase
 * 2) fetching dependencies
 * 3) modifying LocalSettings.php
 * 4) running some maintenance scripts.

Meet the prerequisites
Make sure you've set up MediaWiki and installed Composer.

Get Wikibase
Download the version of Wikibase that matches your Mediawiki installation into the extensions folder of your MediaWiki installation. There are several ways to download Wikibase.

'''Using the wrong version of Wikibase for your Mediawiki installation will result in errors. Be aware that the latest version of Wikibase will not work with Mediawiki version 1.30.0 (latest stable version).'''

Download from Git

 * For getting the latest version of Wikibase, do:
 * For getting a specific version of Wikibase you have to specify the branch you want to download:

Make sure the folder you just downloaded is called  and located in
 * To install Wikibase for Mediawiki version 1.30.0 (latest stable version) use branch REL1_30.

Download archive

 * Instead of using Git you can alternatively download an archive with the latest version of Wikibase or choose to download a specific version of Wikibase.
 * Make sure you extract the archive into a new folder called  inside the extensions folder of your MediaWiki installation.

Recommended way
Using the composer-merge-plugin

Include the following into composer.local.json at the root of your mediawiki installation:

and run from the root of your mediawiki installation: or depending on how Composer was installed on your machine.

Alternative way
or depending on how Composer was installed on your machine.
 * cd into Wikibase inside the extensions folder of your MediaWiki installation:
 * If you've set up Composer correctly, you should be able to fetch all dependencies by running

Adjust your LocalSettings.php
Add the following lines to LocalSettings.php of your MediaWiki installation. You have three options, depending on whether you want to enable Wikibase Repository, Wikibase Client or both of them.

Run the setup scripts
Finally, you have to run some maintenance scripts.

For Wikibase Repository and Wikibase Client

 * Run the database update script of your MediaWiki installation:


 * Run the script that populates the sites table:

For Wikibase Repository only

 * Run

For Wikibase Client only

 * If you want to run a Wikibase Client, you'll also need to run the script that populates the interwiki table:

Wikibase Repository
To verify your Wikibase Repository installation, in your MediaWiki go to Special:NewItem and you should be able to create your first Item. Enter a label and optional description and aliases and hit Create. You should be redirected to the item page.

Wikibase Client
If you've enabled Wikibase Client and everything is correct, you should see an "Add links" link in the languagelinks section in the sidebar of the main page.

= For developers = An easy way so set up a developer environment for Wikibase, is to use one of the wikibase_repo or wikidata role in MediaWiki-Vagrant. They are set up as plain instances including all dependent components, and provides a quick way to get ready for hacking on Wikibase code. The wikibase_repo role provides a simple environment where there is a single repo instance accessible as http://127.0.0.1:8080 (HHVM) or at http://php5.local.wmftest.net:8080 (PHP5). The wikidata role provides a complex environment where there are both repo and client instances. The English client instance is accessible at http://en.wiki.local.wmftest.net:8080 (HHVM) and the repo instance is at http://wikidata.wiki.local.wmftest.net:8080 (HHVM). For the wikibase_repo role the sources of the Wikibase extension can be found under  and sources of dependent components are under , while for the wikidata role the sources are under code>/mediawiki/extensions/WikidataBuildResources/extensions.

There are not so many languages I can set labels for in a new item
Make sure you installed Extension:UniversalLanguageSelector

There are no sites I can set in a new item
One or more of the following may help: