matrix-docker-ansible-deploy/docs/configuring-playbook-dynamic-dns.md

32 lines
1 KiB
Markdown
Raw Normal View History

2020-11-08 01:34:16 +00:00
# Dynamic DNS
2020-10-13 23:18:38 +00:00
2020-11-08 01:34:16 +00:00
## Setup
2020-10-13 23:18:38 +00:00
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).
2020-10-17 04:28:43 +00:00
After you've gotten the proper credentials you can add the following config to your inventory/host_vars/matrix.DOMAIN/vars.yml:
2020-10-13 23:18:38 +00:00
```yaml
2020-11-10 21:30:38 +00:00
matrix_dynamic_dns_enabled: true
2020-11-08 01:34:16 +00:00
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 }}"
2020-10-13 23:18:38 +00:00
```
## Additional Reading
Additional resources:
2020-11-08 01:34:16 +00:00
- https://matrix.org/docs/guides/free-small-matrix-server