Bridge setup with Docker

The Signal bridge requires a second docker container for signald. Instructions for setting up everything can be found on the Signal-specific Bridge setup with Docker page

The Android Messages bridge requires a second docker container for the puppet script.


  • Docker
  • A Matrix homeserver that supports application services (e.g. Synapse)


Docker images are hosted on Available docker tags are generally :latest, :git tag, :git commit-amd64 and :git commit-arm64. The latest and git tag specific docker tags are manifests that contain both amd64 and arm64 images.

  1. Create a directory for the bridge and cd into it: mkdir mautrix-$bridge && cd mautrix-$bridge.
    N.B. The docker image will chown its /data directory to UID 1337. The commands below mount the working directory as /data, so make sure you always run them in the correct directory.
  2. Pull the docker image with docker pull$bridge:<version>. Replace <version> with the version you want to run (e.g. latest or v0.6.0).
  3. Run the container for the first time, so it can create a config file for you:
    docker run --rm -v `pwd`:/data:z$bridge:<version>
  4. Update the config to your liking. You'll at least need to change the homeserver settings, appservice address and permissions.
  5. Generate the appservice registration by running the container again, same command as above.
  6. Add the path to the registration file to your Synapse's homeserver.yaml under app_service_config_files. Restart Synapse to apply changes.
  7. Run the bridge:
    docker run --restart unless-stopped -v `pwd`:/data:z$bridge:<version>
    Additionally, you should either add the bridge to the same Docker network as Synapse with --network=synapsenet, or expose the correct port with -p <port>:<port>.


  1. Pull the new version (setup step 1)
  2. Start the new version (setup step 7)

Docker compose

Create a directory as in step #0 and create docker-compose.yml that contains something like this:

version: "3.7"

    container_name: mautrix-$bridge
    restart: unless-stopped
    - .:/data

Follow the rest of the Docker setup, but use compose commands instead of the raw docker commands: docker-compose up -d to start, docker-compose stop to stop and docker-compose pull to update.