A web admin panel for a self-hosted Chatto server. Chatto's own administration is the operator CLI, which means SSH-ing to the host for routine jobs. This wraps the common ones in a browser UI with several levels of access, so you can hand day-to-day moderation to people you don't want to give a shell.
Not affiliated with Chatto or ChattoCorp. It's an independent tool that drives Chatto's documented operator CLI from the outside.
Before you install this: the panel needs the Docker socket, which is equivalent to root on the host. Read
docs/SECURITY.mdfirst — it explains what that means and how to run this safely.
- Chatto Users — create, rename, edit roles/email, set passwords, suspend/unsuspend, delete, and bulk role moves.
- Overview dashboard — user counts, storage breakdown, disk headroom, container health, and growth trends.
- Multiple servers — manage several Chatto deployments from one panel.
- Admins — panel-only logins with explicit, tiered permissions.
- Audit log — who changed what, from which IP, and when.
- Chat Logs — live-tail, filter, copy, and download Chatto application logs, with secret redaction.
- Backups — scheduled or on-demand snapshots, download, restore, pruning.
- Maintenance — audit/storage retention and old-image cleanup.
- Server Settings — safe, allow-listed Chatto configuration with preview, backup, health-checked restart, and rollback.
- Updates — checks for and applies new Chatto images with automatic backup and rollback safety.
See docs/FEATURES.md for full behavioral detail on
every feature above.
Screenshots aren't included yet — they're planned before the 1.0.0 release. See
docs/FEATURES.mdfor what each page does in the meantime.
| Overview | Manage Servers | Users |
|---|---|---|
| coming soon | coming soon | coming soon |
Requirements
- A working self-hosted Chatto deployment using the
docker composeexample - Docker with the Compose plugin
- The panel on the same host as Chatto (it talks to the local Docker socket)
- Python 3.11+ (only needed for local development or script use outside Docker)
Install
scripts/installThis runs prerequisite checks, discovers an existing local Chatto Compose
deployment, previews the changes, and writes them only after you confirm.
For manual setup, remote hosts (SSH/VPS, Proxmox LXC), multi-server
configuration, and every installer flag, see
DEPLOYMENT.md.
| Doc | Covers |
|---|---|
docs/SECURITY.md |
The Docker-socket threat model, what's protected, and panel-admin permissions |
docs/FEATURES.md |
Full behavior for every feature, plus the role model and known issues |
DEPLOYMENT.md |
Install, Compose, multi-server config, updater sidecar, and rollout |
docs/ARCHITECTURE.md |
Internal design and the multi-server registry/authorization model |
ROADMAP.md |
What's done, in progress, and planned |
CHANGELOG.md |
User-facing and operational changes by release |
Contributions are welcome. See CONTRIBUTING.md for local
setup, the verification command (scripts/check), and repository layout.
MIT. See LICENSE.