Skip to content

About

A UI to control matrix synapse servers using the admin API.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Morpheus Manage (local)

Local web admin UI for Synapse with focused workflows for users, rooms, media operations, and audit review.

Setup

  1. Install Node.js 18+.
  2. Copy .env.example to .env only if you want to change the local port or preconfigure an optional fallback token. You no longer need to put a homeserver in .env.
  3. Install dependencies:
npm install
  1. Start the server:
npm start

Then open http://localhost:4173 in your browser.

Notes

  • This app proxies requests to the Synapse Admin API; admin access tokens stay on the server side.
  • The UI starts at /login.html and 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_URL and SYNAPSE_ADMIN_TOKEN are 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.

Current feature areas

  • 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)

Page map

  • Home
    • System status: /index.html
    • Recent actions: /actions.html
  • Users
    • Directory: /users.html
    • Activity and audits: /audits.html
    • User activity detail: /user.html?user_id=@user:server
  • Rooms
    • All rooms: /rooms.html
    • Room moderation: /room.html?room_id=!room:server
  • 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

Environment variables

  • 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 (default 4173).
  • ACTION_LOG_MAX_ENTRIES (optional): Max retained local action feed entries (default 5000).
  • JSON_BODY_LIMIT (optional): JSON request size limit, e.g. 12mb.
  • MAX_AVATAR_UPLOAD_BYTES (optional): Max avatar upload size in bytes (default 5242880).
  • MEDIA_QUERY_MAX_LIMIT (optional): Max media/report query page size allowed by this UI (default 500).

About

A UI to control matrix synapse servers using the admin API.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages