User:Dan Shick (WMDE)/Drafts/Docker

Introduction
The Wikibase team is now regularly releasing Docker images with MediaWiki, Wikibase and associated services. With a little customization, you can install exactly the kind of Wikibase instance you need.

Before you start

 * You’ll need to have docker and docker-compose installed on the computer where you want to run your Wikibase instance.
 * The Wikibase team recommends providing at least 8GiB of RAM for a complete Docker install including all services.
 * You can get quick insight into your Docker resource usage with the  command; also check out Docker’s documentation on resource constraints.

Service configuration

 * 1) Clone the wikibase-release-pipeline repository.
 * 2) Copy the   file to a file named   and populate the following sections with your own custom usernames and passwords:
 * 3) Mediawiki Configuration
 * 4) Database Configuration
 * 5) To install MediaWiki, Wikibase and a backing database, you can now run   in the directory where you have your   and   files.
 * 6) To install more services

Download the base docker-compose file and place it on the machine where you have Docker Engine and docker-compose installed.


 * 1) In the directory that now contains the   file, run the following to pull the needed Docker machine images:
 * 2) Start the machine images in the background:    (To view the continuous output, you can run  )
 * 3) Verify that all the services have started.
 * 4) Run  . You should see eight images in an “Up” state.
 * 5) Check the logs for success or errors – for example, using this command:
 * 6) Try to load the front end and the query interface in your browser (see below).

For more detailed information, check out the README in the examples section of the wikibase-release-pipeline repository.

Using your new instance
Once all the services have started, you can begin the exciting process of filling up, extending and customizing your empty instance of Wikibase. Take a look at our setup resources page to get started.