Repository navigation
Home
Wayfindr is an open-source, self-hostable support platform for live chat, email,
a help centre, consent-based cobrowsing, and durable ticketing — with reporting
over the conversations and tickets it handles. The project reached v1.0.0 on
September 30, 2026.
The latest public release is v1.3.0, at 1bae329c, published October 10,
2026. All five exact-main CI jobs and the guarded publisher passed; independent
readback verified Release assets, manifest, both amd64/arm64 OCI chains and
stable aliases. This release publishes the Docker 29 correction, helper 0.5.0
and its separate supported upgrade CLI. An enrolled 1.2.0 host must upgrade
its helper separately; an application image pull cannot replace host code.
No operator action or migration is required; standing backup-queue guidance
remains. See Releases for the public receipt and exact identities.
The real 1.2.0 → 1.3.0 minor pair is available, but managed application
qualification remains open with zero qualified scenarios. Development main
is 1.4.0-dev after PR #1136; that reset published no release.
The previous public release is v1.2.0. Its ARM64 published-source install,
enrollment, idle restart/reboot and separate ordinary restore passed over
private HTTP. Those observations and older dated evidence remain on
Disposable VM Evidence and Releases.
It is a working support desk, but operators should still treat every installation as an actively managed system rather than a set-and-forget appliance.
Inbound email depends on which version you are running. Public v0.9.0 and
later let Mailgun and Postmark post straight to POST /api/mail/inbound once
WAYFINDR_INBOUND_MAIL_PROVIDER names the matching verification scheme. The
original Wayfindr-signed proxy contract still verifies, so an install that
built one can keep it. On v0.7.0, direct provider webhooks are not supported:
that release verifies only Wayfindr's X-Wayfindr-Signature scheme, and a
provider's normal webhook returns 401 until a proxy re-signs it.
docs/self-hosting/inbound-mail.md covers all three.
- Evaluating Wayfindr or standing up a disposable VM? Start with Quick Start and Disposable VM Evidence.
- Choosing a deployment shape? Read Installation and Runtime and Operations.
- Already running it? Read Upgrading before pulling a new release.
- Protecting real support data? Read Backup, Restore, and Rollback and Security and Privacy first.
- Wondering what is shipped versus parked? Read Project Status.
- Quick Start
- Project Status
- Installation
- Upgrading
- Runtime and Operations
- Disposable VM Evidence
- Backup, Restore, and Rollback
- Security and Privacy
- Operator Runbook
- Troubleshooting
- Releases
- Contributing
The Wiki is a curated front door, not a second source of technical truth. The
authoritative contracts live in the repository's
documentation.
Wiki source is reviewed in
docs/wiki
and published through the documented sync workflow after it reaches main.