Quick start with Docker

Introduction

We’ve put together a set of machines in Docker that should have you up and running in no time. This configuration starts an empty instance of Wikibase, a MediaWiki front end with query interface, a query backend, ElasticSearch, and a QuickStatements bulk editing service.

Before you start

Getting the machine images running

  1. Download the docker-compose file and place it on the computer where Docker Engine and docker-compose are installed.
  2. In the directory that now contains the docker-compose.yml file, run the following to pull the needed Docker machine images:

    docker-compose pull

  3. Start the machine images in the background:

    docker-compose up -d

    (To view the continuous output, you can run docker-compose logs -f)

  4. Verify that all the services have started.

    1. Run docker-compose ps. You should see eight images in an “Up” state.
    2. Check the logs for success or errors -- for example, using this command:

      docker-compose logs --tail="20" -t

    3. Try to load the front end and the query interface in your browser (see below).

Using your new instance

Once all the services have started, you can begin to explore your empty instance of Wikibase.

Maintenance

Stop the containers

This command stops the Docker containers, leaving the machines (and of course all data) intact:

docker-compose stop

As you might imagine, you can use docker-compose start to start them again.

Delete only the containers

This command removes the containers but preserves all data in MySQL, Mediawiki and the query service in Docker volumes.

docker-compose down

Remove the containers and data

WARNING: this will remove ALL of the data you may have added to MediaWiki, Wikibase, the QueryService and ElasticSearch.

docker-compose down --volumes


For more information, check out this README from the wikibase-docker repository on GitHub.