Wikibase Suite (WBS) and each WBS Docker Image have independent version numbers. Each WBS release identifies the compatible image versions it uses, while images can be released independently.
They all use semantic versioning, written as MAJOR.MINOR.PATCH. Major releases may require upgrade work, while minor and patch releases remain compatible.
This page explains how to read these versions. For update instructions, see Upgrading.
A WBS version identifies a published WBS configuration in this repository, including the Docker Compose file and its image selections. WBS 8 and later releases use Git tags such as wbs@8.0.1.
Compare the current and target versions from left to right. The first number that changes determines the version level:
| Version level | Example | What it means |
|---|---|---|
| Major | 8.1.0 → 9.0.0 |
May contain breaking changes and require version-specific upgrade steps. |
| Minor | 8.0.1 → 8.1.0 |
Adds compatible functionality. |
| Patch | 8.0.0 → 8.0.1 |
Provides a compatible fix. |
WBS 7 and earlier releases use deploy@MAJOR.MINOR.PATCH tags. WBS 8 and later releases use wbs@MAJOR.MINOR.PATCH tags.
The WBS Docker Images—Wikibase, Query Service, Query Service frontend, OpenSearch, and QuickStatements—are released and versioned separately from WBS. WBS releases normally use compatible major-version tags. For example, wikibase/wikibase:7 tracks the latest 7.x.x Wikibase image without pulling breaking changes from a later major version.
WBS Docker Images are published to Docker Hub with tags at the following version levels:
| Version level | Example | What it means |
|---|---|---|
| Major | 7 |
Moves to the latest minor or patch release within that major version. WBS uses these tags so compatible image updates can be pulled without changing the WBS version. |
| Minor | 7.1 |
Moves to the latest patch release within that minor version. |
| Patch | 7.1.0 |
Identifies a specific image release. |
Some images also publish tags for the version of the software they contain, such as the bundled MediaWiki or Query Service version. See Wikibase Suite (WBS) Docker Images for details.