Yuva

One inbox for every product you run.

Website · Docs · API ·
Releases · Roadmap

Yuva is an open-source support inbox. Support e-mail, live chat and in-app messages from all your
products land in one shared inbox. You host it yourself: one Docker image and Postgres.

[!WARNING]
Pre-alpha. The API and database schema can change without migration paths, and the code has
not had an independent security audit. Try it with test data, not real customer conversations.

What you get

• One inbox per product, each with its own branding, language, hours and team.
• E-mail, live chat and in-app messages in one conversation: the <yuva-chat> web component,
  iOS and Android SDKs, and an API.
• Your users stay yours. Your backend signs identity tokens; signed webhooks tell it what happened.
• Build on it with API keys, bots, an event feed and an MCP server for AI assistants.

Quick start

1. Write compose.yaml and .env from the install guide.

2. Start it:

   docker compose up -d
   

3. Create the first owner:

   docker compose exec yuva /yuva bootstrap --email [email protected] --workspace "Example"
   

4. Put it behind HTTPS and sign in with the code that arrives by e-mail.

Documentation

How it is built: architecture. What changed: changelog.

Contributing

Read CONTRIBUTING.md first; contributions are made under the CLA.
Report security issues privately as described in SECURITY.md.

License

The server and panel are AGPL-3.0. The SDKs (sdk/) and the API contract (openapi/)
are MIT, so you can ship them in closed-source apps. Details in
LICENSING.md; name and logo in TRADEMARK.md.