# Synapse-Admin

Synapse-Admin is a self-hosted infrastructure app. Web-based admin panel for managing a Matrix Synapse homeserver through a browser, covering user management, aliases, and server settings. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/623/synapse-admin

## Description

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.

## Health score

67/100 (Good), based on 4 of 5 factors.
- Maintained: 69 (last commit 65 days ago)
- Popular: 62 (1,205 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 100 (no serious findings, CI, tests)

## Links

- Official website: https://awesome-technologies.github.io/synapse-admin/
- GitHub: https://github.com/Awesome-Technologies/synapse-admin
- Docker Hub: https://hub.docker.com/r/awesometechnologies/synapse-admin/
- Unraid: https://ca.unraid.net/apps/synapse-admin-1mzoj4u1afctwi?q=synapse-admin

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/623/synapse-admin), the self-hosted and open-source app directory.
