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 f455b0e420
GHA: reintroduce an env var for `$GITHUB_HEAD_REF` (#10659)
11 hours ago
.ci Remove fixed and flakey tests from the sytest blacklist (#10788) 2 weeks ago
.github GHA: reintroduce an env var for `$GITHUB_HEAD_REF` (#10659) 11 hours ago
changelog.d GHA: reintroduce an env var for `$GITHUB_HEAD_REF` (#10659) 11 hours ago
contrib Update the Synapse Grafana dashboard (#10570) 1 month ago
debian 1.43.0rc2 4 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) 2 weeks ago
docs Fix #10837 by adding JSON encoding/decoding to the Module API example… (#10845) 3 days ago
scripts Add a partial index to `presence_stream` to speed up startups (#10748) 2 weeks ago
scripts-dev Add a script to update the debian changelog for non-Debian systems (#10778) 2 weeks ago
snap Added explicit Python build tools to snap requirements (#7213) 1 year ago
stubs Add types to synapse.util. (#10601) 1 week ago
synapse Require type hints in the handlers module. (#10831) 14 hours ago
synmark Remove redundant "coding: utf-8" lines (#9786) 5 months ago
tests Create a constant for a small png image in tests. (#10834) 4 days ago
.codecov.yml Disable codecov reports to GH comments. 2 years ago
.coveragerc set TOP in sytest containers 1 month 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 Add hyperlink to #9424 in changelog 4 days ago
CONTRIBUTING.md Advertise matrix-org.github.io/synapse docs (#10595) 3 weeks ago
INSTALL.md Fix broken links in INSTALL.md (#10331) 2 months ago
LICENSE Reference Matrix Home Server 7 years ago
MANIFEST.in Teach MANIFEST and tox about ci->.ci 1 month ago
README.rst Advertise matrix-org.github.io/synapse docs (#10595) 3 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 Require type hints in the handlers module. (#10831) 14 hours ago
pylint.cfg Added pylint config file: ignore missing-docstring messages. 7 years ago
pyproject.toml Bump black configuration to target py36 (#9781) 5 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) 2 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 1 month 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