https://github.com/chattocorp/chatto
A fully-featured team and group chat application that you can easily selfhost.
https://github.com/chattocorp/chatto
chat communication gdpr-compliant privacy-first screensharing video-calls voice-calls
Last synced: about 12 hours ago
JSON representation
A fully-featured team and group chat application that you can easily selfhost.
- Host: GitHub
- URL: https://github.com/chattocorp/chatto
- Owner: chattocorp
- License: agpl-3.0
- Created: 2026-04-08T14:50:12.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-07-29T20:10:14.000Z (5 days ago)
- Last Synced: 2026-07-29T20:10:23.324Z (5 days ago)
- Topics: chat, communication, gdpr-compliant, privacy-first, screensharing, video-calls, voice-calls
- Language: Go
- Homepage: https://chatto.run
- Size: 24.2 MB
- Stars: 2,414
- Watchers: 7
- Forks: 107
- Open Issues: 231
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
- Notice: NOTICE
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-github-repos - chattocorp/chatto - A fully-featured team and group chat application that you can easily selfhost. (Go)
README
[](https://github.com/chattocorp/chatto/actions/workflows/ci.yml?query=branch%3Amain)
[](https://github.com/chattocorp/chatto/actions/workflows/release.yml)
[](https://github.com/chattocorp/chatto/releases)
[](LICENSE)
# Chatto
A really good chat application for teams and communities, free and easy to self-host, with [cloud hosting available soon](https://chatto.run/cloud).
- [Website](https://chatto.run)
- [Documentation](https://docs.chatto.run)
- [Official Chatto Community](https://chat.chatto.run/)
- [Releases](https://github.com/chattocorp/chatto/releases)
- [Security Policy](SECURITY.md)
- [Contributing](CONTRIBUTING.md)
This repository temporarily incubates the early
[Authling](authling/README.md) identity-provider module. Authling is developed
and released independently from Chatto and is intended to move to its own
repository once it no longer needs frequent atomic changes with the shared
[event-sourcing framework](pkg/events/README.md),
[embedded NATS runtime](pkg/natsruntime/README.md),
[data-cryptography primitives](pkg/datacrypto/README.md), and
[application-configuration loader](pkg/appconfig/README.md).
## Complete Local Stack
The root [`compose.yml`](compose.yml) runs Chatto, Authling, Mailpit, LiveKit,
Storybook, and the Chatto docs website together on
[OrbStack](https://docs.orbstack.dev/docker/domains). It builds every
repository-owned service from the current checkout, gives Chatto and Authling
separate persistent embedded-NATS storage, and configures Chatto to use
Authling as an OpenID Connect provider through Chatto's public Client ID
Metadata Document, without preregistering Chatto in Authling. Compose derives
the project name from the checkout directory, keeping containers and OrbStack
domains isolated between worktrees.
```sh
docker compose up --build
```
For a checkout in a directory named ``, open these OrbStack-managed
HTTPS origins:
- Chatto: `https://chatto..orb.local`
- Authling: `https://authling..orb.local`
- Mailpit: `https://mailpit..orb.local`
- LiveKit signaling: `https://livekit..orb.local`
- Storybook: `https://storybook..orb.local`
- Docs website: `https://docs-website..orb.local`
Create an Authling account, read its verification code in Mailpit, then choose
**Authling** on Chatto's login screen. Chatto asks for a username on the first
login because Authling's initial OIDC profile intentionally shares only its
stable account ID. The stack also bootstraps a Chatto owner named
`compose-admin` with the development-only password `compose-admin`.
After login, select the cloud button below the server list. Authling asks for
separate permission to read and write account data. The cloud turns green when
the TinyBase connection is active. Chatto then stores the public server list in
Authling. Server URLs, names, icons, and registration times synchronize; Chatto
login tokens and user details stay only in that browser. The frontend shows a
trusted Authling sign-in action and can use the resulting browser session to
start login on Chatto servers that advertise the same issuer. The frontend and
each Chatto server still receive separate tokens and scopes.
The frontend reads its Authling issuer from `/client-config.json`. The Compose
stack sets `CHATTO_FRONTEND_AUTHLING_ISSUER`, so the bundled Chatto server
publishes that document and a separate frontend CIMD identity automatically.
A standalone web, desktop, or mobile client can publish or inject the same
versioned JSON contract from its own trusted application origin.
The checked-in credentials and bootstrap account are for local development
only. Stop the stack with `docker compose down`; add `--volumes` to delete both
products' data and establish a fresh Authling issuer on the next start. The
stack relies on OrbStack's default Compose domains, automatic HTTPS proxy, and
container CA installation; it is not a production deployment example.
## License
Chatto is licensed under `AGPL-3.0-or-later` by default. The independently
versioned shared framework modules, standalone frontend, integration surfaces,
documentation, and examples use Apache-2.0. See
[LICENSING.md](LICENSING.md) and [REUSE.toml](REUSE.toml) for the exact
boundary.
The project licenses do not grant permission to use Chatto names or logos as
official branding for a fork or modified version; see [NOTICE](NOTICE).
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for local development notes. This project is **not accepting outside contributions** at this time.