mash-playbook/docs/interoperability.md

2 KiB

Configuring interoperability with other services

This playbook tries to get you up and running with minimal effort and provided you have followed the example vars.yml file, will install the Traefik reverse-proxy server by default.

Sometimes, you're using a server which already has Traefik. In such cases these are undesirable:

  • the playbook trying to run its own Traefik instance and running into a conflict with your other Traefik instance over ports (tcp/80 and tcp/443)

  • multiple playbooks trying to install Docker, etc.

Below, we offer some suggestions for how to make this playbook more interoperable. Feel free to cherry-pick the parts that make sense for your setup.

Disabling Traefik installation

If you're installing Traefik on your server in another way, you can use your already installed Traefik instance and disable the Traefik instance installed by MASH.

If you are using the matrix-docker-ansible-deploy playbook, it already runs its own Traefik instance (matrix-traefik). We recommend that you disable the Traefik instance installed by MASH, because the Traefik instance installed by the Matrix playbook does the same, but also contains additional configuration for handling the Matrix federation port (8448).

Disabling Docker installation

If you're installing Docker on your server in another way, disable this component from the playbook:

mash_playbook_docker_installation_enabled: false

Disabling timesyncing (systemd-timesyncd / ntp) installation

If you're installing systemd-timesyncd or ntp on your server in another way, disable this component from the playbook:

devture_timesync_installation_enabled: false