1. Get your own domain, if you don't yet have one

   • Maybe pick one up for free at Freenom

2. Add the domain to Cloudflare

3. Create a configuration file based on example.com.yml and put it in a directory named zones

   • The script can only update existing records, so make sure you manually create them first at dash.cloudflare.com
   • Change proxied: to false if the domain is used for practically anything other than HTTP/S traffic

docker run --name=cloudflare-ddns -d --restart=always \
-v /your/zones/directory:/zones \
-e ZONE_NAME="example.com" \
xescure/cloudflare-ddns:latest-amd64

By default this will update the selected domain every minute to your current public IP. Simple as that.

A custom update schedule can be set by adding -e REFRESH_SCHEDULE="<your cron schedule expression>" to the docker run command. If you are not sure about cron, consult crontab.guru ;)

The image is fully compatible with the Raspberry Pi, just use the tag xescure/cloudflare-ddns:latest-arm or build it for yourself by cloning the repository and running docker build -t cloudflare-ddns .

Logs can be found at /logs/your.domain.log.

If persistent logging is needed, use -v /where/you/want/your/logs:/logs.

version: '3.3'
services:
    cloudflare-ddns:
        image: xescure/cloudflare-ddns:latest-amd64
        container_name: cloudflare-ddns
        restart: always
        volumes:
            - '/docker/cloudflare-ddns/zones:/zones'
            - '/docker/cloudflare-ddns/logs:/logs'
        environment:
            - ZONE_NAME=your.domain
            - REFRESH_SCHEDULE=*/5 * * * *

Work in progress

The project is based on xordiv/docker-alpine-cron and adrienbrignon/cloudflare-ddns, huge thanks to them!

• CRON_STRINGS - strings with cron jobs. Use "\n" for newline (Default: undefined)

• CRON_TAIL - if defined cron log file will read to stdout by tail (Default: undefined) - note from xescure: i might break this once I implement proper logging

By default cron is running in the foreground

• /var/log/cron/cron.log - the default location for cron's logs

• /etc/cron.d - custom crontab files mounted here will be copied to the proper location and activated