helmo / wikibase-docker

🐳 Docker images and example compose file for Wikibase and surrounding services

wikibase-docker

This repo contains Docker images needed to setup a local Wikibase instance and a query service.

Each image contained within this repo has its own README with more detailed information:

Image name	Description	README
wikibase/wikibase	MediaWiki with the Wikibase extension	README
wikibase/wdqs	Blazegraph SPARQL query service backend	README
wikibase/wdqs-proxy	Proxy to make the query service READONLY and enforce query timeouts	README
wikibase/wdqs-frontend	UI for the SPARQL query service	README
wikibase/quickstatements	UI to add data to Wikibase	README

Docker compose example

This repo contains an EXAMPLE docker compose setup for Wikibase (specified in the docker-compose.yml file) that combines the images described above to set up a fully-featured local Wikibase environment. You can use that file as a base to build a custom environment tailored to your needs.

To try it out, make sure you have Docker installed, then just clone this repository, enter its directory and run docker-compose up -d. Once that step completes, you should have:

• a MediaWiki wiki fully configured with Wikibase, available at http://localhost:8181
• a Wikidata Query Service instance available at http://localhost:8282
• a QuickStatements instance, available at http://localhost:9191

Note that the Wikibase instance has no data; no items or properties. To add some data, use the Special:NewItem and Special:NewProperty pages in the local wiki; then you can add statements to the added items using the properties you defined.

For more information about this example enviroment, please see the README-compose.md file.

Issue tracking

We use Phabricator to track issues. See the list of current issues.

Development

New images will be build and automatically pushed to docker hub when merged on master. Builds on branches and in PRs will not be pushed.

Each image directory contains a README with a separate Development section for how updates of that image generally work.

The following steps relate to all images:

• Update the various .travis/build-deploy.sh scripts to correctly tag the images that are being built, including updating the latest tag.
• Update .travis.yml to reflect new or removed images

Further reading

For beginner-friendly light reading on the subject of using these images / this repo, check out the posts under this tag, specifically:

• Announcement of the creation of these images
• First basic example usage (the wikibase registry)
• Customizing the example docker-compose file
• Creating your own Dockerfile for wikibase
• Example update process for wikibase
• Changing the concept URI of an existing Wikibase with data