Skip to content
A small amd64/ARM/ARM64 Docker image that allows you to use CloudFlare as a DDNS / DynDNS Provider.
Branch: master
Clone or download
oznu Merge pull request #10 from gamerlv/patch-1
Typo in backup V6 detection
Latest commit 51fd3d1 Jun 3, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
root Typo in backup V6 detection Jun 3, 2018
.travis.yml travis ci docker does not support manifest command - removing May 30, 2018
Dockerfile Ipv6 support + aarch64 variant (#6) May 28, 2018 check public ip is returned May 30, 2018

Travis Docker Pulls

Docker CloudFlare DDNS

This small Alpine Linux based Docker image will allow you to use the free CloudFlare DNS Service as a Dynamic DNS Provider (DDNS).

Image Variants

Image Tag Architecture OS Size
latest x64 Alpine Linux
armhf arm32v6 Alpine Linux
aarch64 arm64 Alpine Linux


Quick Setup:

docker run \
  -e \
  -e API_KEY=xxxxxxx \
  -e \
  -e SUBDOMAIN=subdomain \

This image will also run on a Raspberry Pi or other ARM based boards that support Docker using the armhf or aarch64 tags:

docker run \
  -e \
  -e API_KEY=xxxxxxx \
  -e \
  -e SUBDOMAIN=subdomain \


  • --restart=always - ensure the container restarts automatically after host reboot.
  • -e EMAIL - Your CloudFlare email address. Required
  • -e API_KEY - Your CloudFlare API Key. Get it here: Required
  • -e ZONE - The DNS zone that DDNS updates should be applied to. Required
  • -e SUBDOMAIN - A subdomain of the ZONE to write DNS changes to. If this is not supplied the root zone will be used.
  • -e PROXIED - Set to true to make traffic go through the CloudFlare CDN. Defaults to false.
  • -e RRTYPE=A - Set to AAAA to use set IPv6 records instead of IPv4 records. Defaults to A for IPv4 records.
  • -e DELETE_ON_STOP - Set to true to have the dns record deleted when the container is stopped. Defaults to false.

Multiple Domains

If you need multiple records pointing to your public IP address you can create CNAME records in CloudFlare.


If you're wanting to set IPv6 records set the envrionment variable RRTYPE=AAAA. You will also need to run docker with IPv6 support, or run the container with host networking enabled.

Docker Compose

If you prefer to use Docker Compose:

version: '2'
    image: oznu/cloudflare-ddns:latest # change 'latest' to 'armhf' or 'aarch64' if running on an arm device
    restart: always
      - API_KEY=xxxxxxx
      - SUBDOMAIN=subdomain
      - PROXIED=false
You can’t perform that action at this time.