Quick start with Docker
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
- You’ll need to have docker and docker-compose installed on the computer where you want to run your Wikibase instance.
- Together, these Docker machines require at least 4GB of memory.
- Check out Docker’s documentation on resource constraints.
- An empty Wikibase running on Docker requires at minimum 6GB of disk storage.
Getting the machine images running
- Download the docker-compose file and place it on the computer where Docker Engine and docker-compose are installed.
- In the directory that now contains the
docker-compose.ymlfile, run the following to pull the needed Docker machine images:
sudo docker-compose pull
- Start the machine images in the background:
sudo docker-compose up -d(To view the continuous output, you can run
sudo docker-compose logs -f)
- Verify that all the services have started.
sudo docker-compose ps. You should see eight images in an “Up” state.
- Check the logs for success or errors – for example, using this command:
sudo docker-compose logs --tail="20" -t
- 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 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.