====== Matrix.org Chat ======
see also: [[synapse|Synapse]]

===== DNS =====

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

===== nginx =====

<file 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;
}</file>

===== Docker =====

| [[https://hub.docker.com/r/matrixdotorg/synapse|matrixdotorg/synapse]] | Home server reference implementation in Python |
| [[https://hub.docker.com/r/avhost/docker-matrix-riot|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:

  * email address
  * phone number
  * Facebook account

===== Roadmap / current issues =====
See the following repositories/tags:
  * [[https://github.com/vector-im/riot-meta/|vector-im/riot-meta]]

^ E2E and cross signing | [[https://github.com/vector-im/riot-meta/issues/222|riot-meta#222]] |

===== further reading =====
  * [[https://jo-so.de/2018-03/Matrix.html|Erkenntnisse und Erfahrungen rund um Matrix 🇩🇪]]
  * [[https://www.kuketz-blog.de/messenger-matrix-das-xmpp-fuer-hobby-admins/|Messenger: Matrix – Das XMPP für Hobby-Admins 🇩🇪]]
==== Specs ====
  * [[https://matrix.org/docs/spec/client_server/latest.html|Client-Server API]]

===== troubleshooting =====

==== Federation doesn't work ====
there's a [[https://federationtester.matrix.org/|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).