> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pgw.sipmicro.services/llms.txt
> Use this file to discover all available pages before exploring further.

# Release notes

> What changed in each pgw release, and the changes that need action when you upgrade.

Before you upgrade across a release marked **Breaking**, read its entry and [Upgrade pgw](https://docs.pgw.sipmicro.services/upgrade.md).

**0.4.0**

November 13, 2026

* One PBX serves many SIP domains. List names and wildcards, such as `*.example.com`, on its upstream with `--domains`.
* In managed mode, each user names its domain, so `1001@acme.example.com` and `1001@globex.example.com` are two accounts.
* A tenant can't list a name that overlaps another tenant's name, or a wildcard on a public suffix such as `*.com`.
* Log lines carry their level, so `journalctl` colors errors and warnings, and `journalctl -p warning` filters by level. Choose the style with `log_color`.
* `pgw init` writes every setting and every field, with its default, in `config.yaml` and `tenant.yaml`.
* Fix: Linphone registers in managed mode when it answers both of pgw's digest challenges in one REGISTER.

**0.3.3**

November 12, 2026

* Logs are `key=value` text. Each line names the device, its app, and its PBX.
* New log lines for registrations, unregistrations, and call outcomes.
* Name an app with `pgw app set-name`. Its log lines show the name instead of the bundle ID.
* **Breaking.** Logs default to text. Set `log_format: json` to keep JSON.
* **Breaking.** The `upstream` log field holds the PBX name. Its ID is in `upstream_id`.

**0.3.2**

November 10, 2026

* Wake browser apps with Web Push.
* In managed mode, ring every device of a user at once. The first device to answer takes the call.
* **Breaking** for managed mode setups that upgrade from 0.3.1. Set `PGW_MANAGED_REGISTRATION=per_device` first to keep registering each device. See [Upgrade pgw](https://docs.pgw.sipmicro.services/upgrade.md).
* Set up a test install in one step with `pgw init`.
* Keep a tenant's apps, upstreams, and users in a YAML file with `pgw config export` and `pgw config sync`.
* Log every SIP message, with secrets masked, with `sip_log`.

**0.3.1**

October 30, 2026

* Test fixes only. pgw behaves as in 0.3.0.

**0.3.0**

October 29, 2026

* Look up SIP users in Kamailio's subscriber database.
* Authenticate app REGISTERs with a Bearer token from your identity provider.
* Accept browser apps over secure WebSocket.

**0.2.0**

October 16, 2026

* Managed mode, where pgw checks the SIP password and renews the registration at the PBX itself.
* Check that each PBX is reachable with OPTIONS.
* Send one device a silent test push from the CLI or API.

**0.1.0**

October 13, 2026

* Hold incoming calls and wake iOS and Android apps through APNs and FCM.
* Passthrough mode, where the app answers the PBX's challenge and pgw stores no SIP password.
* Prometheus metrics, health checks, and logs that never contain push tokens.

## Next steps

> [card] [Upgrade pgw](https://docs.pgw.sipmicro.services/upgrade.md)
>
> Follow the steps that each **Breaking** release needs.

> [card] [Back up, move, and restore pgw](https://docs.pgw.sipmicro.services/backup-move-restore.md)
>
> Take a backup before you upgrade, so that you can roll back.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.