Table of Contents

Matrix.org Chat

see also: Synapse

DNS

_matrix._tcp.example.com. 1800 IN	SRV	5 900 8448 example.com.

nginx

/home/example/conf/web/nginx.example.com.conf
# This will send any path that starts
# with /_matrix to our Synapse!
 
location /_matrix {
	proxy_pass http://localhost:8008;
}

Docker

matrixdotorg/synapse Home server reference implementation in Python
avhost/docker-matrix-riot Web chat

FAQ

should I host my own identity server?

Yes, if you want your users to be able to use third party identifiers (3PID) to discover each other.

Examples for 3PIDs:

Roadmap / current issues

See the following repositories/tags:

E2E and cross signing riot-meta#222

further reading

Specs

troubleshooting

Federation doesn't work

there's a federation tester.

Riot

Invalid /api/v1 response

If you get this error it could be because you specified an identity server in /.well-known/matrix/client which doesn't provide that functionality (e.g. synapse which is only a home server, not an identity server).