matrix-docker-ansible-deploy/roles/matrix-server/tasks/setup_synapse.yml

---

- name: Ensure Matrix Synapse data path exists
  file:
    path: "{{ matrix_synapse_data_path }}"
    state: directory
    mode: 0750
    owner: "{{ matrix_user_username }}"
    group: "{{ matrix_user_username }}"

- name: Ensure Matrix Docker image is pulled
  docker_image:
    name: "{{ docker_matrix_image }}"

- name: Check if a Matrix Synapse configuration exists
  stat:
    path: "{{ matrix_synapse_data_path }}/homeserver.yaml"
  register: matrix_synapse_config_stat

- name: Generate initial Matrix config
  docker_container:
    name: matrix-config
    image: "{{ docker_matrix_image }}"
    detach: no
    cleanup: yes
    command: generate
    env:
      SERVER_NAME: "{{ hostname_matrix }}"
      REPORT_STATS: "no"
    user: "{{ matrix_user_uid }}:{{ matrix_user_gid }}"
    volumes:
      - "{{ matrix_synapse_data_path }}:/data"
  when: "not matrix_synapse_config_stat.stat.exists"

- name: Augment Matrix config (configure SSL fullchain location)
  lineinfile: "dest={{ matrix_synapse_data_path }}/homeserver.yaml"
  args:
    regexp: "^tls_certificate_path:"
    line: 'tls_certificate_path: "/acmetool-certs/live/{{ hostname_matrix }}/fullchain"'

- name: Augment Matrix config (configure SSL private key location)
  lineinfile: "dest={{ matrix_synapse_data_path }}/homeserver.yaml"
  args:
    regexp: "^tls_private_key_path:"
    line: 'tls_private_key_path: "/acmetool-certs/live/{{ hostname_matrix }}/privkey"'

- name: Augment Matrix config (configure server name)
  lineinfile: "dest={{ matrix_synapse_data_path }}/homeserver.yaml"
  args:
    regexp: "^server_name:"
    line: 'server_name: "{{ hostname_identity }}"'

- name: Augment Matrix config (disable TURN for guests)
  lineinfile: "dest={{ matrix_synapse_data_path }}/homeserver.yaml"
  args:
    regexp: "^turn_allow_guests:"
    line: 'turn_allow_guests: False'

- name: Augment Matrix config (enable URL previews)
  lineinfile: "dest={{ matrix_synapse_data_path }}/homeserver.yaml"
  args:
    regexp: "^url_preview_enabled:"
    line: 'url_preview_enabled: True'

- name: Augment Matrix config (specify URL previews blacklist)
  lineinfile: "dest={{ matrix_synapse_data_path }}/homeserver.yaml"
  args:
    regexp: "^url_preview_ip_range_blacklist:"
    line: 'url_preview_ip_range_blacklist: ["127.0.0.0/8", "10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16", "100.64.0.0/10", "169.254.0.0/16"]'
    insertafter: '^# url_preview_ip_range_blacklist:$'

# We only wish to do this for the 8008 port and not for the 8448 port
# (2nd instance of `x_forwarded` found in the config)
- name: Augment Matrix config (mark 8008 plain traffic as forwarded)
  replace: "dest={{ matrix_synapse_data_path }}/homeserver.yaml"
  args:
    regexp: "8008((?:.|\n)*)x_forwarded(.*)"
    replace: '8008\g<1>x_forwarded: true'

- name: Augment Matrix config (change database from SQLite to Postgres)
  lineinfile:
    dest: "{{ matrix_synapse_data_path }}/homeserver.yaml"
    regexp: '(.*)name: "sqlite3"'
    line: '\1name: "psycopg2"'
    backrefs: yes

- name: Augment Matrix config (add the Postgres connection parameters)
  lineinfile:
    dest: "{{ matrix_synapse_data_path }}/homeserver.yaml"
    regexp: '(.*)database: "(.*)homeserver.db"'
    line: '\1user: "{{ matrix_postgres_connection_username }}"\n\1password: "{{ matrix_postgres_connection_password }}"\n\1database: "homeserver"\n\1host: "postgres"\n\1cp_min: 5\n\1cp_max: 10'
    backrefs: yes

- name: Augment Matrix config (configure Coturn)
  lineinfile: "dest={{ matrix_synapse_data_path }}/turnserver.conf"
  args:
    regexp: "^{{ item.variable }}="
    line: '{{ item.variable }}={{ item.value }}'
  with_items:
    - {'variable': 'min-port', 'value': "{{ matrix_coturn_turn_udp_min_port }}"}
    - {'variable': 'max-port', 'value': "{{ matrix_coturn_turn_udp_max_port }}"}
    - {'variable': 'external-ip', 'value': "{{ matrix_coturn_turn_external_ip_address }}"}

- name: Augment Matrix config (set max upload size)
  lineinfile: "dest={{ matrix_synapse_data_path }}/homeserver.yaml"
  args:
    regexp: "^max_upload_size:"
    line: 'max_upload_size: "{{ matrix_max_upload_size_mb }}M"'

- name: Allow access to Matrix ports in firewalld
  firewalld:
    port: "{{ item }}"
    state: enabled
    immediate: yes
    permanent: yes
  with_items:
    - '8448/tcp' # Matrix federation
    - '3478/tcp' # STUN
    - '3478/udp' # STUN
    - "{{ matrix_coturn_turn_udp_min_port }}-{{ matrix_coturn_turn_udp_max_port }}/udp" # TURN

- name: Ensure matrix-synapse.service installed
  template:
    src: "{{ role_path }}/templates/systemd/matrix-synapse.service.j2"
    dest: "/etc/systemd/system/matrix-synapse.service"
    mode: 0644

- name: Ensure matrix-synapse-register-user script created
  template:
    src: "{{ role_path }}/templates/usr-local-bin/matrix-synapse-register-user.j2"
    dest: "/usr/local/bin/matrix-synapse-register-user"
    mode: 0750

- name: Ensure periodic restarting of Matrix is configured (for SSL renewal)
  template:
    src: "{{ role_path }}/templates/cron.d/matrix-periodic-restarter.j2"
    dest: "/etc/cron.d/matrix-periodic-restarter"
    mode: 0600