synapse-old/contrib/docker
Richard van der Hoff 3149d55b7d
Merge pull request #3778 from z3ntu/patch-1
Fix build of Docker image with docker-compose
2018-11-01 17:34:56 +00:00
..
README.md
docker-compose.yml Merge pull request #3778 from z3ntu/patch-1 2018-11-01 17:34:56 +00:00

README.md

Synapse Docker

Automated configuration

It is recommended that you use Docker Compose to run your containers, including this image and a Postgres server. A sample docker-compose.yml is provided, including example labels for reverse proxying and other artifacts.

Read the section about environment variables and set at least mandatory variables, then run the server:

docker-compose up -d

If secrets are not specified in the environment variables, they will be generated as part of the startup. Please ensure these secrets are kept between launches of the Docker container, as their loss may require users to log in again.

Manual 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, simply run:

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

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