Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions src/how-to/upgrade/05-config-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
4 changes: 4 additions & 0 deletions src/how-to/upgrade/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
24 changes: 24 additions & 0 deletions src/how-to/upgrade/config-references/wire-server-5.26.0.md
Original file line number Diff line number Diff line change
@@ -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).
17 changes: 17 additions & 0 deletions src/how-to/upgrade/config-references/wire-server-5.27.0.md
Original file line number Diff line number Diff line change
@@ -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).
31 changes: 31 additions & 0 deletions src/how-to/upgrade/config-references/wire-server-5.28.0.md
Original file line number Diff line number Diff line change
@@ -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
86 changes: 86 additions & 0 deletions src/how-to/upgrade/config-references/wire-server-5.29.0.md
Original file line number Diff line number Diff line change
@@ -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: {}
```
Loading