matrix-docker-ansible-deploy/docs/configuring-playbook-dynamic-dns.md
Slavi Pantaleev 5c5f828405 Use more YAML-like syntax for the dynamic DNS configurations
Related to #681 (Github Pull Request)
2020-11-10 23:49:36 +02:00

32 lines
1 KiB
Markdown

# Dynamic DNS
## Setup
Most cloud providers / ISPs will charge you extra for a static IP address. If you're
not hosting a highly reliable homeserver you can workaround this via dynamic DNS. To
set this up, you'll need to get the username/password from your DNS provider. For
google domains, this process is described [here](https://support.google.com/domains/answer/6147083).
After you've gotten the proper credentials you can add the following config to your inventory/host_vars/matrix.DOMAIN/vars.yml:
```yaml
matrix_dynamic_dns_enabled: true
matrix_dynamic_dns_domain_configurations: |
{{
[{'provider': 'domains.google.com', 'protocol': 'dyndn2', 'username': 'XXXXXXXXXXXXXXXX', 'password': 'XXXXXXXXXXXXXXXX', 'domain': matrix_domain}]
}}
matrix_dynamic_dns_domain_configurations:
- provider: domains.google.com
protocol: dyndn2
username: XXXXXXXXXXXXXXXX
password: XXXXXXXXXXXXXXXX
domain: "{{ matrix_domain }}"
```
## Additional Reading
Additional resources:
- https://matrix.org/docs/guides/free-small-matrix-server