Ketesa
Admin UI for Matrix servers, formerly Synapse Admin. Drop-in replacement with extended features, multi-backend support, and visual customization.
Install / Use
/learn @etkecc/KetesaREADME
📖 About
Ketesa is the evolution of Synapse Admin — a fully independent admin interface for Matrix homeservers. What began as a fork of Awesome-Technologies/synapse-admin has grown into its own project, with a redesigned interface, comprehensive API coverage, multi-language support, and powerful management tools that go far beyond the original.
Ketesa is a fully compatible drop-in replacement for Synapse Admin. Migration is straightforward and requires no configuration changes:
| | Method | How |
|---|---|---|
| ☁️ | Hosted (CDN) | Use admin.etke.cc — nothing to install |
| 🐳 | Docker | Replace the image tag with ghcr.io/etkecc/ketesa:latest |
| 📦 | Static files | Replace your existing dist directory with the Ketesa release tarball |
Whether you're managing a small private server or a large federated community, Ketesa gives you the visibility and control you need — all from a clean, responsive web interface.
💬 Questions? Join the community room or open an issue on GitHub.
✨ Features
👥 Complete user management
Ketesa covers the full lifecycle of a Matrix user account. You can suspend, shadow-ban, deactivate, or permanently erase users. Fine-grained controls let you manage rate limits, experimental features, and account data. You can view and manage third-party identifiers, connected devices (create, rename, delete), room memberships, and cross-signing keys — all from one place. Need to onboard many users at once? Bulk registration via CSV import handles it, including third-party identifiers. Passwords can be generated randomly or reset manually. User avatars carry role badges (admin, bot, support, federated, system-managed) so you can identify account types at a glance.
When Matrix Authentication Service (MAS) is in use, Ketesa extends user management with MAS-native capabilities: browsing and revoking active sessions (compat, OAuth2, and personal), managing linked email addresses, reviewing upstream OAuth provider links, and creating users through MAS directly.
🏠 Powerful room management
Get a full picture of every room on your server. Block or unblock rooms, purge history, and delete rooms entirely. The messages viewer lets you browse room history with filters and jump-to-date navigation. Spaces are handled natively with a dedicated room hierarchy tab. You can assign room admins and join users to rooms directly from the UI. Media can be quarantined, protected, or deleted at file, user, or room scope.
📄 Room management guide · 📄 Media management guide
🔐 Flexible authentication
Log in with a username and password, a raw access token, or via OIDC/SSO — whatever your server setup requires. Ketesa has first-class support for Matrix Authentication Service (MAS), including full session management and registration token administration. It also ships a dedicated external auth provider mode that adapts the interface when Synapse delegates authentication to an external system.
⚙️ Deep customization
Every data table in Ketesa is built with react-admin's Configurable component, so users can show, hide, and reorder columns to match their workflow — no code changes needed.
Beyond the per-user table preferences, Ketesa can be tailored at the deployment level through a
config.json file (or via /.well-known/matrix/client):
restrict which homeservers users can connect to,
add custom navigation menu items,
pre-fill the login form,
configure CORS credentials,
and protect appservice-managed users (bridge puppets) from accidental edits.
📊 Server statistics and insights
Monitor your server with built-in statistics views: per-user media usage and database room stats give you a clear picture of what's consuming space. The federation overview shows the health and reachability of remote destinations. Reported events can be reviewed and acted upon directly from the reports list.
📄 Server statistics guide · 📄 Federation guide · 📄 Event reports guide
🌍 Available in 9 languages
Ketesa ships with full translations in English, German, French, Japanese, Russian, Persian, Ukrainian, Chinese, and Italian — every string is fully translated, with no untranslated English stubs left behind.
📱 Mobile-friendly by design
The interface is fully responsive. Wherever you are, you can manage your server from a phone or tablet without sacrificing functionality. Tables collapse to readable mobile lists, long identifiers wrap gracefully, and every action is reachable on small screens.
🌟 Built by etke.cc — and it shows
Ketesa is built and actively maintained by etke.cc, a managed Matrix hosting provider with a genuine open-source-first philosophy. Every feature in this project is open source, developed in the open, and free to use by anyone.
If you run your Matrix server on etke.cc, Ketesa becomes something even more powerful: a unified control plane for your entire server. Instead of juggling separate dashboards, log files, and support channels, everything you need is right here — in the same interface you already use for user and room management:
| | Feature | What it does | |---|---|---| | 🟢 | Server health | Live status badge in the toolbar + a full dashboard showing every server component with color-coded indicators, error details, and suggested actions. Know what's wrong before your users do. | | 🔔 | Notifications | Important server events surface as an in-app feed with an unread badge — nothing slips through the cracks. | | ⚡ | Server actions | Trigger management commands on demand, schedule them for a precise date and time, or set up recurring weekly jobs. Routine maintenance becomes a few clicks, not a cron job. | | 💳 | Billing | View payment history, transaction details, and download invoices without ever leaving the admin panel. | | 💬 | Support | Open support requests, track their progress, and exchange messages with the etke.cc team — right from the interface you use every day. | | 🎨 | White-labelling | Custom name, logo, favicon, and background applied automatically from the platform. No extra configuration, no deploy step. |
💡 Interested? Learn more about etke.cc managed Matrix hosting →
📦 Availability
| | Where | Details |
|---|---|---|
| 🏠 | etke.cc | Core component of the managed hosting platform |
| 🌐 | admin.etke.cc | Hosted instance, always on the latest version |
| 📦 | GitHub Releases | Prebuilt tarballs for root-path and /admin subpath deployment |
| 🐳 | Docker Hub / GHCR | Official Docker images |
| 🤖 | matrix-docker-ansible-deploy | Ansible playbook component |
| ❄️ | Nix package | Maintained by @Defelo |
| 🐧 | Arch Linux AUR | Maintained by @drygdryg |
| 🌊 | IPFS | Maintained by Fеnикs (@fenuks:sibnsk.net) —
Related Skills
openhue
342.0kControl Philips Hue lights and scenes via the OpenHue CLI.
sag
342.0kElevenLabs text-to-speech with mac-style say UX.
weather
342.0kGet current weather and forecasts via wttr.in or Open-Meteo
tweakcc
1.5kCustomize Claude Code's system prompts, create custom toolsets, input pattern highlighters, themes/thinking verbs/spinners, customize input box & user message styling, support AGENTS.md, unlock private/unreleased features, and much more. Supports both native/npm installs on all platforms.
