Synapse: Matrix reference homeserver http://matrix.org
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
David Robertson 9ffa787eb2
Fix typo again
7 days ago
.ci Remove fixed and flakey tests from the sytest blacklist (#10788) 3 weeks ago
.github Avoid duplicate issues from Twisted trunk failures (#10672) 1 month ago
changelog.d 1.43.0rc2 2 weeks ago
contrib Update the Synapse Grafana dashboard (#10570) 1 month ago
debian 1.43.0 7 days ago
demo Handle all new rate limits in demo scripts (#9858) 5 months ago
docker Fix frontend_proxy jinja script in docker workers (#10783) 3 weeks ago
docs Fix copy-paste error in the password section of the sample-config. (#10804) 2 weeks ago
scripts Add a partial index to `presence_stream` to speed up startups (#10748) 3 weeks ago
scripts-dev Add a script to update the debian changelog for non-Debian systems (#10778) 3 weeks ago
snap Added explicit Python build tools to snap requirements (#7213) 1 year ago
stubs Add types to synapse.util. (#10601) 2 weeks ago
synapse 1.43.0 7 days ago
synmark Remove redundant "coding: utf-8" lines (#9786) 6 months ago
tests Use direct references for some configuration variables (#10798) 2 weeks ago
.codecov.yml Disable codecov reports to GH comments. 2 years ago
.coveragerc set TOP in sytest containers 2 months ago
.dockerignore Reduce the amount of stuff we send in the docker context (#5564) 2 years ago
.editorconfig Add a basic .editorconfig 3 years ago
.git-blame-ignore-revs Add a list of hashes to ignore during git blame. (#9560) 7 months ago
.gitignore Compile and render Synapse's docs into a browsable, mobile-friendly and searchable website (#10086) 4 months ago
AUTHORS.rst Automatically delete empty groups/communities (#6453) 2 years ago
CHANGES.md Fix typo again 7 days ago
CONTRIBUTING.md Advertise matrix-org.github.io/synapse docs (#10595) 4 weeks ago
INSTALL.md Fix broken links in INSTALL.md (#10331) 3 months ago
LICENSE Reference Matrix Home Server 7 years ago
MANIFEST.in Teach MANIFEST and tox about ci->.ci 2 months ago
README.rst Advertise matrix-org.github.io/synapse docs (#10595) 4 weeks ago
UPGRADE.rst fix broken link to upgrade notes (#10631) 1 month ago
book.toml Compile and render Synapse's docs into a browsable, mobile-friendly and searchable website (#10086) 4 months ago
mypy.ini Add types to synapse.util. (#10601) 2 weeks ago
pylint.cfg Added pylint config file: ignore missing-docstring messages. 7 years ago
pyproject.toml Bump black configuration to target py36 (#9781) 6 months ago
setup.cfg Fix (final) Bugbear violations (#9838) 5 months ago
setup.py Extend the release script to tag and create the releases. (#10496) 2 months ago
synctl Improve the error message printed by synctl when synapse fails to start. (#10059) 4 months ago
sytest-blacklist Remove fixed and flakey tests from the sytest blacklist (#10788) 3 weeks ago
test_postgresql.sh Use interpreter from $PATH instead of absolute paths in various scripts using /usr/bin/env (#9689) 6 months ago
tox.ini Teach MANIFEST and tox about ci->.ci 2 months ago

README.rst

=========================================================================
Synapse |support| |development| |documentation| |license| |pypi| |python|
=========================================================================

.. contents::

Introduction
============

Matrix is an ambitious new ecosystem for open federated Instant Messaging and
VoIP. The basics you need to know to get up and running are:

- Everything in Matrix happens in a room. Rooms are distributed and do not
exist on any single server. Rooms can be located using convenience aliases
like ``#matrix:matrix.org`` or ``#test:localhost:8448``.

- Matrix user IDs look like ``@matthew:matrix.org`` (although in the future
you will normally refer to yourself and others using a third party identifier
(3PID): email address, phone number, etc rather than manipulating Matrix user IDs)

The overall architecture is::

client <----> homeserver <=====================> homeserver <----> client
https://somewhere.org/_matrix htt