v0.1.0
v0.1.0 — narrowly supported stable release
This is the first non-prerelease OMP Session Gateway release. Stable describes the exact supported matrix below; it does not claim compatibility with unnamed hosts, browsers, OMP builds, or remote-access paths.
Advertised combinations
| role | combination |
|---|---|
| host | Debian 13 (trixie) x86-64, systemd 257, kernel 6.12.94+deb13-amd64 |
| host | macOS 26.6.1 arm64 (Mac14,3) |
| client | Chrome 151.0.7922.171 on Android 17 (Pixel 10 Pro) |
Per-lane evidence and the qualifying candidate are recorded in docs/RELEASE_STATUS.md and docs/COMPATIBILITY.md at this source commit.
Required deployment preconditions
- Run OMP v17.4.1 at 9350b7990d26ebf69a604edc82d8558ef04adf30 with the patch included in this archive. Stock OMP is not sufficient at any version. Paired OMP packaging is not provided; use the documented versioned omp-gateway-patched route.
- Run Tailscale's TUN-mode client and Tailscale Serve over tailnet HTTPS. Userspace networking, Funnel, Portal Tunnel, and self-hosted or proxied relays are not supported.
Known environment limitation
Exact candidate .23 recovered the same loaded page automatically after secure lock, an Airplane outage, and forced Doze, without a reload. Android Chrome can still wedge its process-wide network state outside those proven transitions. Native EventSource reconnection and the bounded snapshot fallback recover the qualified cases; after an uninterrupted prolonged visible outage the loaded shell exposes force-stop/reopen help. The release does not claim page JavaScript can restart a failed browser process.
Windows remains unadvertised. Background Web Push delivery remains best-effort and is not part of the stable core support claim.
Install or upgrade
Extract omp-session-gateway-0.1.0-bun.tar, then run bun apps/gateway/src/cli.js install --origin https://host.tailnet.ts.net --allow user@example.com with the deployment's real values. Repeat --allow for additional identities. Active reinstall preserves configuration and the publisher token.
Rollback
Run bun apps/gateway/src/cli.js rollback when the predecessor is present in managed installation history. Otherwise reinstall the signed v0.1.0-beta.1 archive with the deployment's existing origin and allowlist. Gateway rollback does not roll back the separately activated patched OMP executable.
- Source commit: 07ba8be
- OMP baseline: 9350b7990d26ebf69a604edc82d8558ef04adf30 (tag v17.4.1) with the included patch
- Runtime: Bun 1.3.14; registry protocol 1; Push API 2
- Verification: https://github.com/alphastorm/omp-session-gateway/blob/07ba8be884c268375890d50b1a6af51f22bdb16a/docs/RELEASE.md