History

Fabian Meyer dd57715de2 contrib/docker-compose: fixing mount that overrides containers' /etc (#6656 ) The mount in the form of ./matrix-config:/etc overwrites the contents of the container /etc folder. Since all valid ca certificates are stored in /etc, the synapse.push.httppusher, for example, cannot validate the certificate from matrix.org.		2020-01-08 07:25:05 +00:00
..
README.md	Update docker-compose.yml for a static config file, and update traefik examples (#6142 )	2019-10-18 11:23:33 +02:00
docker-compose.yml	contrib/docker-compose: fixing mount that overrides containers' /etc (#6656 )	2020-01-08 07:25:05 +00:00

README.md

Synapse Docker

Configuration

A sample docker-compose.yml is provided, including example labels for reverse proxying and other artifacts. The docker-compose file is an example, please comment/uncomment sections that are not suitable for your usecase.

Specify a SYNAPSE_CONFIG_PATH, preferably to a persistent path, to use manual configuration.

To generate a fresh homeserver.yaml, you can use the generate command. (See the documentation for more information.) You will need to specify appropriate values for at least the SYNAPSE_SERVER_NAME and SYNAPSE_REPORT_STATS environment variables. For example:

docker-compose run --rm -e SYNAPSE_SERVER_NAME=my.matrix.host -e SYNAPSE_REPORT_STATS=yes synapse generate

(This will also generate necessary signing keys.)

Then, customize your configuration and run the server:

docker-compose up -d

More information

For more information on required environment variables and mounts, see the main docker documentation at /docker/README.md