From 01116c68257b9f7bb8ca12ce2401f0855c2cdb4a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vedran=20Ivankovi=C4=87?= <33936733+Veki301@users.noreply.github.com> Date: Mon, 30 Mar 2026 19:31:37 +0200 Subject: [PATCH 1/5] add config reference 5.26.0 --- .../config-references/wire-server-5.26.0.md | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 src/how-to/upgrade/config-references/wire-server-5.26.0.md diff --git a/src/how-to/upgrade/config-references/wire-server-5.26.0.md b/src/how-to/upgrade/config-references/wire-server-5.26.0.md new file mode 100644 index 0000000..a9d8e13 --- /dev/null +++ b/src/how-to/upgrade/config-references/wire-server-5.26.0.md @@ -0,0 +1,24 @@ +# Wire-Server 5.26.0 release + +The following reference was written based on the following [`build.json` charts](https://raw.githubusercontent.com/wireapp/wire-builds/7023ffdd52f9de2a1eb5ce2e01cefaf16253274b/build.json). + +For additional details, you can also read our [release changelog](https://github.com/wireapp/wire-server/releases/tag/v2026-01-26). + +## Known bugs + +Previous release introduced a bug into `background-worker` default settings for `postgresMigration` and have now been correctly set to Cassandra. If you are relying on default values from our charts, but have migrated your conversations to PostgreSQL, update your config accordingly to keep using PostgreSQL. Specifically, this value: + +``` +background-worker: + config: + postgresMigration: + conversation: postgresql | cassandra # default is cassandra, and should be if not migrated to postgresql +``` + +## Mandatory (breaking) changes + +No mandatory changes. + +## Optional changes + +Conversation codes can now be migrated to PostgreSQL. For details, read our [changelog](https://github.com/wireapp/wire-server/releases/tag/v2026-01-26). From a0761df4e2a8bdebb62008eafa967d67e56fcb86 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vedran=20Ivankovi=C4=87?= <33936733+Veki301@users.noreply.github.com> Date: Mon, 30 Mar 2026 19:31:46 +0200 Subject: [PATCH 2/5] add config reference 5.27.0 --- .../config-references/wire-server-5.27.0.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 src/how-to/upgrade/config-references/wire-server-5.27.0.md diff --git a/src/how-to/upgrade/config-references/wire-server-5.27.0.md b/src/how-to/upgrade/config-references/wire-server-5.27.0.md new file mode 100644 index 0000000..8eb335c --- /dev/null +++ b/src/how-to/upgrade/config-references/wire-server-5.27.0.md @@ -0,0 +1,17 @@ +# Wire-Server 5.27.0 release + +The following reference was written based on the following [`build.json` charts](https://raw.githubusercontent.com/wireapp/wire-builds/d8bdda07fd4c32937a5482711b6e322a32d0c784/build.json). + +For additional details, you can also read our [release changelog](https://github.com/wireapp/wire-server/releases/tag/v2026-02-04). + +## Known bugs + +No known bugs + +## Mandatory (breaking) changes + +No mandatory changes + +## Optional changes + +Team features can now be migrated to PostgreSQL. For details, read our [changelog](https://github.com/wireapp/wire-server/releases/tag/v2026-02-04). \ No newline at end of file From 051f249e94ad0f4415f570267cbe0a03dd5e203f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vedran=20Ivankovi=C4=87?= <33936733+Veki301@users.noreply.github.com> Date: Mon, 30 Mar 2026 19:31:56 +0200 Subject: [PATCH 3/5] add config reference 5.28.0 --- .../config-references/wire-server-5.28.0.md | 31 +++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 src/how-to/upgrade/config-references/wire-server-5.28.0.md diff --git a/src/how-to/upgrade/config-references/wire-server-5.28.0.md b/src/how-to/upgrade/config-references/wire-server-5.28.0.md new file mode 100644 index 0000000..8e42a2e --- /dev/null +++ b/src/how-to/upgrade/config-references/wire-server-5.28.0.md @@ -0,0 +1,31 @@ +# Wire-Server 5.28.0 release + +The following reference was written based on the following [`build.json` charts](https://raw.githubusercontent.com/wireapp/wire-builds/93632dd82237c122c93e0e37e02e5f2a1ba84746/build.json). + +For additional details, you can also read our [release changelog](https://github.com/wireapp/wire-server/releases/tag/v2026-03-03). + +## Known bugs + +No known bugs + +## Mandatory (breaking) changes + +The following Helm charts were changed: + +- `demo-smtp` +- `fake-aws-ses` +- `fake-aws-sns` +- `legalhold` + +Image field overrides are now controlled with split values, `repository` + `tag`, unlike a full `image` string like previously, if you were using overrides in these charts, change to this format: + +``` +affected-chart: + image: + repository: quay.io/wire/... + tag: some-tag +``` + +## Optional changes + +No optional changes \ No newline at end of file From 9a08acb0dddcf214f78537de89a353e6b779fa84 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vedran=20Ivankovi=C4=87?= <33936733+Veki301@users.noreply.github.com> Date: Mon, 30 Mar 2026 19:32:35 +0200 Subject: [PATCH 4/5] add config reference 5.29.0 --- .../config-references/wire-server-5.29.0.md | 86 +++++++++++++++++++ 1 file changed, 86 insertions(+) create mode 100644 src/how-to/upgrade/config-references/wire-server-5.29.0.md diff --git a/src/how-to/upgrade/config-references/wire-server-5.29.0.md b/src/how-to/upgrade/config-references/wire-server-5.29.0.md new file mode 100644 index 0000000..18d1d95 --- /dev/null +++ b/src/how-to/upgrade/config-references/wire-server-5.29.0.md @@ -0,0 +1,86 @@ +# Wire-Server 5.29.0 release + +The following reference was written based on the following [`build.json` charts](https://raw.githubusercontent.com/wireapp/wire-builds/eaaec058bd49e392ab8727a02c568782f709c81a/build.json). + +For additional details, you can also read our [release changelog](https://github.com/wireapp/wire-server/releases/tag/v5.29.0). + +## Known bugs + +No known bugs + +## Mandatory (breaking) changes + +Wire-server core services were migrated from subcharts into the umbrella chart templates. As a result, dependency tags for these services are now obsolete. Out of these, `proxy` service might be the only breaking change if it was not used previously and is unconfigured. + +### `proxy` + +If `proxy` was used previously and is already configured, you have no breaking changes. + +Since proxy can no longer be "toggled off" the following configuration with dummy secrets is sufficient for deploy. + +``` +proxy: + secrets: + proxy_config: |- + secrets { + youtube = "..." + googlemaps = "..." + soundcloud = "..." + giphy = "..." + spotify = "Basic ..." + } +``` + +## Optional changes + +### `wire-server` + +This value in `wire-server` charts is now obsolete and can be removed if used: + +``` +tags: + proxy: false # or true +``` + +### `proxy` + +The following is full config options for the `proxy` chart and are shown as defaults as they come set in charts. They are not required to be set in your `values.yaml`. Do not change unless necessary. + +``` +proxy: + replicaCount: 3 + image: + repository: quay.io/wire/proxy + tag: wire-server-release-version + service: + externalPort: 8080 + internalPort: 8080 + imagePullPolicy: "" + metrics: + serviceMonitor: + enabled: false + resources: + requests: + memory: "25Mi" + cpu: "50m" + limits: + memory: "50Mi" + config: + logLevel: Info + logFormat: StructuredJSON + logNetStrings: false + proxy: {} + # Disable one ore more API versions. Please make sure the configuration value is the same in all these charts: + # brig, cannon, cargohold, galley, gundeck, proxy, spar. + disabledAPIVersions: [development] + + podSecurityContext: + allowPrivilegeEscalation: false + capabilities: + drop: + - ALL + runAsNonRoot: true + seccompProfile: + type: RuntimeDefault + secrets: {} +``` \ No newline at end of file From abd7b839aa638d71c390322400a93e5149f38d5e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vedran=20Ivankovi=C4=87?= <33936733+Veki301@users.noreply.github.com> Date: Mon, 30 Mar 2026 19:32:44 +0200 Subject: [PATCH 5/5] add config references links --- src/how-to/upgrade/05-config-reference.md | 4 ++++ src/how-to/upgrade/README.md | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/src/how-to/upgrade/05-config-reference.md b/src/how-to/upgrade/05-config-reference.md index c2a553c..26757d3 100644 --- a/src/how-to/upgrade/05-config-reference.md +++ b/src/how-to/upgrade/05-config-reference.md @@ -35,6 +35,10 @@ Apply each configuration change to your templates as applicable to your model. - [Wire Server 5.24.0](config-references/wire-server-5.24.0.md) - [Wire Server 5.25.0](config-references/wire-server-5.25.0.md) +- [Wire Server 5.26.0](config-references/wire-server-5.26.0.md) +- [Wire Server 5.27.0](config-references/wire-server-5.27.0.md) +- [Wire Server 5.28.0](config-references/wire-server-5.28.0.md) +- [Wire Server 5.29.0](config-references/wire-server-5.29.0.md) ## Contributing diff --git a/src/how-to/upgrade/README.md b/src/how-to/upgrade/README.md index 84571fa..b6b8128 100644 --- a/src/how-to/upgrade/README.md +++ b/src/how-to/upgrade/README.md @@ -13,3 +13,7 @@ Complete documentation for upgrading `wire-server` deployments. ## 5. [Configuration Reference](05-config-reference.md) - [Wire Server 5.24.0](config-references/wire-server-5.24.0.md) - [Wire Server 5.25.0](config-references/wire-server-5.25.0.md) + - [Wire Server 5.26.0](config-references/wire-server-5.26.0.md) + - [Wire Server 5.27.0](config-references/wire-server-5.27.0.md) + - [Wire Server 5.28.0](config-references/wire-server-5.28.0.md) + - [Wire Server 5.29.0](config-references/wire-server-5.29.0.md)