Synapse-Admin

Web-based admin panel for managing a Matrix Synapse homeserver through a browser, covering user management, aliases, and server settings.

  • Infrastructure
  • Network Services
  • Tools & Utilities
Web-based admin panel for managing a Matrix Synapse homeserver through a browser, covering user management, aliases, and server settings. Requires Synapse v1.93.0 or later for full functionality.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

67/100 Good

Maintained
69last commit 65 days ago
Popular
621,205 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
100no serious findings, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 53 days ago

GitHub stars
1,205
Open issues
80
Last commit
2026-09-17
Latest release
0.11.4
License
Apache-2.0
Activity
stale

Checked 20 days ago - source: GitHub (Awesome-Technologies/synapse-admin)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Preboot scripts for container startup If your Synapse container needs a startup task, such as creating HTTPS certificates (the digital keys that help secure web access), put a small command file at /vertex/boothooks/preboot.sh. Without it, the container will not automatically run that setup each time it starts. source
  • Creating an admin user The logged-in user must have admin privileges. To create an admin user, run: register_new_matrix_user -c /data/homeserver.yaml http://0.0.0.0:8008 (adjust the homeserver.yaml path and port to match your Synapse setup). source

Fetched 37 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Which Synapse version must be available for synapse-admin to work fully?

All functions work as expected only with Synapse version 1.93.0 or newer. You can check the server version using the server version admin API.

Do I need to install synapse-admin as part of Synapse?

No, Synapse does not have a built-in admin interface. You host the synapse-admin project separately and sign in with an admin account.

How do I create or promote a Matrix account that can log in to synapse-admin?

If your server already has an admin account, use the User Admin API to promote other accounts to admins. If no admin account exists yet, you will have to edit the database manually.

How do I run synapse-admin with Docker?

Run the public Docker container and map container port 80 to a host port such as 8080. You can also start it with the provided docker-compose file.

Answers sourced from github.com, matrix-org.github.io, www.reddit.com

Community

Collected 49 days ago - public community threads