Fediversity/matrix/synapse-admin/README.md

1.1 KiB

Synapse-admin

This is the webgui for Synapse.

Installation can be done in 3 ways (see Github), 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 is fairly straightforward, see here.

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.

{
  "restrictBaseUrl": "https://vm02199.procolix.com"
}