Synapse-Admin
Web-based admin panel for managing a Matrix Synapse homeserver through a browser, covering user management, aliases, and server settings.
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
Variants
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
- setup synapse administrator with Microsoft.Resources ... - Reddit (reddit)
- Synapse Forum (forum)
- How to access the synapse-admin web ui? : r/matrixdotorg - Reddit (reddit)
- Forums - Synapse Community Forums (forum)
Collected 49 days ago - public community threads