Dynamic DNS Updates with Cloudflare

This Docker container offers a straightforward and efficient solution for automating dynamic DNS updates using the Cloudflare DNS service. It empowers you to effortlessly update your DNS records in Cloudflare at predefined intervals, guaranteeing that your services are consistently accessible through a domain name.

Prerequisites

Before you can use this Docker container, ensure you meet the following prerequisites:

• Docker: Docker installation guide
• Cloudflare DNS: Cloudflare zone setups guide

Installation

This script runs as a Docker container, which means installation is as simple as pulling the pre-built Docker container and running it with the necessary environment variables

docker run -d -e API_KEY=123 -e ZONE_ID=023e105f4ecef8ad9ca31a8372d0c353 -e DOMAIN_NAMES=example.com,*.example.com mxmlndml/cloudflare-dynamic-dns

Alternatively you can copy the docker-compose.yml and .env.template from this repository into an empty directory of your machine, rename the .env.template to .env, edit the environment variables in both files and start the container with docker compose

docker compose up -d

Configuration

You can configure this Docker container using environment variables. Here's a breakdown of the available configuration variables:

• API_KEY required
  Cloudflare API token with Zone Settings:Read, Zone:Read and DNS:Edit permissions
• ZONE_ID required
  Zone ID of your website (in the right sidebar on the overview page of your site)
• DOMAIN_NAMES required
  List of DNS A records that should store your public IP address delimited by a comma (and only a comma)
• RECORD_TYPES defaults to A
  Whether A and/or AAAA records should be updated
  A: updates only A records
  AAAA: updates only AAAA records
  *: updates both A and AAAA records
• INTERVAL defaults to 5
  Time interval in minutes between DNS updates