Public | Automated Build

Last pushed: 2 years ago
Short Description
The JS client for Matrix packaged for Docker
Full Description


Dockerfile for installation of matrix open federated Instant Messaging and
VoIP communication server.


To configure run the image with "generate" as argument. You have to setup the
server domain and a /data-directory. After this you have to edit the
generated homeserver.yaml file. Don't forget to configure the
file if you need the web client. Rename this file to deactivate

To get the things done, "generate" will create a own self-signed certificate.

This needs to be changed for production usage.


$ docker run -v /tmp/data:/data --rm -e SERVER_NAME=localhost silviof/docker-matrix generate


For starting you need the port bindings and a mapping for the

$ docker run -d -p 8448:8448 -p 3478:3478 -v /tmp/data:/data silviof/docker-matrix start

Port configurations

This following ports are used in the container. You can use -p-option on
docker run to configure this part (eg.: -p 443:8448).

  • turnserver: 3478,3479,5349,5350 udp and tcp
  • homeserver: 8008,8448 tcp
  • web client: defaults to 8080

Version information

To get the installed synapse version you can run the image with version as
argument or look at the container via cat.

$ docker run -ti --rm silviof/docker-matrix version
-=> Matrix Version: v0.7.1-0-g894a89d
# docker exec -it CONTAINERID cat /synapse.version

Environment variables

  • SERVER_NAME: Server and domain name, mandatory, needed only for generate
  • REPORT_STATS: statistic report, mandatory, values: yes or no, needed
    only for generate

build specific arguments

  • BV_SYN: synapse version, optional, defaults to master
  • BV_VEC: vector version, optional, defaults to master
  • BV_TUR: coturn turnserver version, optional, defaults to master

For building of synapse version v0.11.0-rc2 and vector with commit a9fc47e add
--build-arg BV_SYN=v0.11.0-rc2 --build-arg BV_VEC=a9fc47efd77 to the docker build command.

Exported volumes

  • /data: data-container


You can also generate the example configuration into /srv/matrix/example with

docker-compose -f generate.yml up

Then run the turnserver and matrix with

docker-compose -d up

Debugging the images happens with

docker-compose down

To debug the environments instead of the source images, use

docker-compose stop
docker-compose rm


Docker Pull Command
Source Repository