History

Fridtjof Mund 4aea0bd292 contrib/docker: remove quotes for POSTGRES_INITDB_ARGS (#6984 ) I made a mistake in https://github.com/matrix-org/synapse/pull/6921 - the quotes break the postgres container's startup script (or docker-compose), which makes initdb fail: https://github.com/matrix-org/synapse/pull/6921#issuecomment-590657154 Signed-off-by: Fridtjof Mund <fridtjof@das-labor.org>		2020-02-25 10:48:13 +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: remove quotes for POSTGRES_INITDB_ARGS (#6984 )	2020-02-25 10:48:13 +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