ansible-nas/docs/applications/cloudflare_ddns.md

# Cloudflare Dynamic DNS Updater

Homepage: <https://github.com/joshuaavalon/docker-cloudflare>

Cloudflare: <https://www.cloudflare.com>

If you want your Ansible-NAS accessible externally then you'll need a domain name. You'll also need to set a wildcard
host A record to point to your static IP, or enable this container to automatically update Cloudflare with your dynamic IP address.

## Usage

Set `cloudflare_ddns_enabled: true` in your `inventories/<your_inventory>/nas.yml` file.

Set `cloudflare_token` to the one you grab from the Cloudflare UI (more below).

## Specific Configuration

Make sure you set your domain (if different than the ansible-nas default) and access token details within your `inventories/<your_inventory>/nas.yml` file. If you need to create an API token, see [https://github.com/joshuaavalon/docker-cloudflare/#api-token](https://github.com/joshuaavalon/docker-cloudflare/#api-token) for instructions.

Cloudflare has deprecated global API key authentication. If you have an older ansible-nas configuration using a global API key, you can upgrade to the API token-based authentication by removing the `cloudflare_api_key` variable from your local `nas.yml` configuration file and setting the `cloudflare_token` variable appropriately.
Add Cloudflare dynamic DNS updater 2019-01-15 23:24:18 +00:00			`# Cloudflare Dynamic DNS Updater`

:recycle: big docs refactoring 2022-07-25 20:18:57 +00:00			`Homepage: <https://github.com/joshuaavalon/docker-cloudflare>`

			`Cloudflare: <https://www.cloudflare.com>`
Add Cloudflare dynamic DNS updater 2019-01-15 23:24:18 +00:00
			`If you want your Ansible-NAS accessible externally then you'll need a domain name. You'll also need to set a wildcard`
			`host A record to point to your static IP, or enable this container to automatically update Cloudflare with your dynamic IP address.`

			`## Usage`

Docs inventory reference update 2020-01-25 23:40:26 +00:00			Set `cloudflare_ddns_enabled: true` in your `inventories/<your_inventory>/nas.yml` file.
Add Cloudflare dynamic DNS updater 2019-01-15 23:24:18 +00:00
Clarify that cloudflare needs config 2022-06-17 23:27:15 +00:00			Set `cloudflare_token` to the one you grab from the Cloudflare UI (more below).

Add Cloudflare dynamic DNS updater 2019-01-15 23:24:18 +00:00			`## Specific Configuration`

:recycle: big docs refactoring 2022-07-25 20:18:57 +00:00			Make sure you set your domain (if different than the ansible-nas default) and access token details within your `inventories/<your_inventory>/nas.yml` file. If you need to create an API token, see [https://github.com/joshuaavalon/docker-cloudflare/#api-token](https://github.com/joshuaavalon/docker-cloudflare/#api-token) for instructions.
Updated cloudflare-ddns to use config.yaml, default to API token instead of deprecated global API key Uses config.yaml for docker container instead of deprecated environment variables (which weren't working for me). This change is backwards compatible (old configs using global API key still work-- or will work again). Docs updated to reflect changes. 2020-08-13 23:18:48 +00:00
			Cloudflare has deprecated global API key authentication. If you have an older ansible-nas configuration using a global API key, you can upgrade to the API token-based authentication by removing the `cloudflare_api_key` variable from your local `nas.yml` configuration file and setting the `cloudflare_token` variable appropriately.