/wikibase-docker

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

Primary LanguageShell

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:

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: