Hello,

We would like to announce a major update to the Wikibase Suite product offering: Wikibase Suite Deploy. It’s a total overhaul of what used to be the Wikibase Suite “example” directory, transforming it into a complete deployment kit for Wikibase production environments. 

Highlights:

1. It significantly improves the separation of config, code, and data. Making configuration for deployment clearer, easier, and more robust across updates. Now, all the config lives in a single “config” directory; all data is located in docker volumes; and container images containing the code can be updated individually, without touching config or data. We also consolidated our docker compose files and restructured them for better legibility.

2. We did a total overhaul of the deployment documentation along with individual docs for each of our containers. 

3. We included a Traefik reverse proxy with SSL termination and ACME support; allowing for, among other benefits, QuickStatements Authentication and https certification out of the box.

4. Simplifying our images, we combined the “wikibase” and “wikibase-bundle” images into a single image called “wikibase”. Please note that this means “wikibase-bundle” is now deprecated; however, all of its original functionality remains intact in “wikibase”.

5. A new versioning scheme. Each Wikibase Suite Image is now separately versioned as is the Wikibase Suite Deploy product. The new versioning scheme follows the rules of Semantic Versioning, which you’re likely familiar with already. 

The releases of Wikibase Suite Deploy we’re making today carry a major version for each Mediawiki version we support: 

- Wikibase Suite Deploy 1.0.0 ships Wikibase Image 1.0.0 based on Mediawiki 1.39

- Wikibase Suite Deploy 2.0.0 ships Wikibase Image 2.0.0 based on Mediawiki 1.41

- Wikibase Suite Deploy 3.0.0 ships Wikibase Image 3.0.0 based on Mediawiki 1.42

- All other services such as WDQS and Quickstatements shipped with all Wikibase Suite Deploy versions start on image version 1.0.0 today.

Subsequent releases will be shipped as minor or patch updates to Wikibase Suite Deploy and the Wikibase Suite Images respectively. The upcoming Mediawiki 1.43 will be released as a new Wikibase Suite Deploy major version. Read more about versioning and updating in the Wikibase Suite Deploy documentation.

All Wikibase Suite Image Releases are available on the Wikibase Docker Hub repository, from now on tagged with their semantic version. Here are the MediaWiki release notes for more info.

I want to say a huge thank you to you in the community who have partnered with us along the way trying the software out in production, offering us feedback, answering our and each other’s questions, sharing your needs, and submitting tickets on phabricator. I also want to say a huge thank you to our user researcher and wonderful team of engineers who made realising these improvements possible. We’re excited to continue to work with you to improve Wikibase Suite. 

Let us know how migrating to deploy works out for you and let us know if you need any help by creating a ticket on Phabricator.

Warm Regards, 

The Wikibase Suite team