Local web admin UI for Synapse with focused workflows for users, rooms, media operations, and audit review.
- Install Node.js 18+.
- Copy
.env.exampleto.envonly if you want to change the local port or preconfigure an optional fallback token. You no longer need to put a homeserver in.env. - Install dependencies:
npm install
- Start the server:
npm start
Then open http://localhost:4173 in your browser.
- This app proxies requests to the Synapse Admin API; admin access tokens stay on the server side.
- The UI starts at
/login.htmland lets you choose the homeserver you want to manage directly from the page. - Classic Matrix username/password sign-in is supported for Synapse admin accounts.
- If
SYNAPSE_BASE_URLandSYNAPSE_ADMIN_TOKENare both preconfigured and pass a Synapse admin API health check, opening the main app will skip the login page automatically and use that server-side fallback token. - The login page remembers the last homeserver you used in browser storage so you do not need to keep retyping it.
- Keep Synapse Admin API access private and run this tool only on trusted hosts/networks.
- Destructive actions require confirmation in the UI.
- Users: directory, create user, lock/reactivate/deactivate flows, session review/revoke, profile management.
- Rooms: room list/search/sort, member views, room moderation actions.
- Media:
- Storage dashboard (
/_synapse/admin/v1/statistics/users/media) - Per-user media browser (
/_synapse/admin/v1/users/<user_id>/media) - Per-room media inventory (
/_synapse/admin/v1/room/<room_id>/media+ media metadata) - Reported content queue moderation (
/_synapse/admin/v1/event_reports)
- Storage dashboard (
- Home
- System status:
/index.html - Recent actions:
/actions.html
- System status:
- Users
- Directory:
/users.html - Activity and audits:
/audits.html - User activity detail:
/user.html?user_id=@user:server
- Directory:
- Rooms
- All rooms:
/rooms.html - Room moderation:
/room.html?room_id=!room:server
- All rooms:
- Media
- Storage dashboard:
/media-storage.html - Per-user media browser:
/media-users.html - Per-room media inventory:
/media-rooms.html - Reported content moderation:
/media-reports.html
- Storage dashboard:
SYNAPSE_BASE_URL(optional): Preconfigured homeserver base URL used to prefill login or enable fallback-token mode.SYNAPSE_ADMIN_TOKEN(optional): Preconfigured fallback admin access token (secret).SYNAPSE_SERVER_NAME(optional): Homeserver name override when it should not be derived from the selected homeserver host.PORT: Port for this UI (default4173).ACTION_LOG_MAX_ENTRIES(optional): Max retained local action feed entries (default5000).JSON_BODY_LIMIT(optional): JSON request size limit, e.g.12mb.MAX_AVATAR_UPLOAD_BYTES(optional): Max avatar upload size in bytes (default5242880).MEDIA_QUERY_MAX_LIMIT(optional): Max media/report query page size allowed by this UI (default500).