2024-11-18 16:21:22 +01:00
|
|
|
# Synapse-admin
|
|
|
|
|
|
|
|
This is the webgui for Synapse.
|
|
|
|
|
|
|
|
Installation can be done in 3 ways
|
|
|
|
([see Github](https://github.com/Awesome-Technologies/synapse-admin)), we'll
|
|
|
|
pick the easiest one: using the precompiled tar.
|
|
|
|
|
|
|
|
Unpack it under `/var/www`, link `synapse-admin` to the directory that the
|
|
|
|
archive creates. This is to make sure you can easily unpack a newer version,
|
|
|
|
prepare that, and then change the symlink.
|
|
|
|
|
|
|
|
```
|
|
|
|
# ls -l /var/www
|
|
|
|
total 8
|
|
|
|
drwxr-xr-x 2 root root 4096 Nov 4 18:05 html
|
|
|
|
lrwxrwxrwx 1 root root 20 Nov 18 13:24 synapse-admin -> synapse-admin-0.10.3
|
|
|
|
drwxr-xr-x 5 root root 4096 Nov 18 15:54 synapse-admin-0.10.3
|
|
|
|
```
|
|
|
|
|
|
|
|
We use 0.10.3, but point nginx to '/var/www/synapse-admin'. Configuring nginx
|
2024-11-18 16:24:23 +01:00
|
|
|
is fairly straightforward, [see here](../nginx/README.md#synapse-admin).
|
2024-11-18 16:21:22 +01:00
|
|
|
|
|
|
|
You should probably restrict Synapse-Admin to your own Synapse-server, instead
|
|
|
|
of letting users fill in whatever they want. Do this by adding this bit to
|
|
|
|
`config.json`. In our config we've moved that file to
|
|
|
|
`/etc/synapse-admin` and link to that from `/var/www/synapse-admin`.
|
|
|
|
|
|
|
|
```
|
|
|
|
{
|
2024-12-04 12:07:59 +01:00
|
|
|
"restrictBaseUrl": "https://matrix.example.com"
|
2024-11-18 16:21:22 +01:00
|
|
|
}
|
|
|
|
```
|