cloudflare-ddns(1)

cloudflare-ddns1

Dynamically update a dns record

Usage

cloudflare-ddns [api_token record_name] [--config file]

Overview

cloudflare-ddns is a tool that can be used to dynamically update a DNS record using Cloudflare's API.

This tool is a oneshot program: you run it, it updates the DNS record, and it terminates. To make it run periodically you could use a systemd timer or a cron job.

To run the tool you'll need an API token: https://dash.cloudflare.com/profile/api-tokens; cloudflare-ddns only needs the Zone.DNS edit permission.

You can run cloudflare-ddns in two different ways: you can pass the API Token and the record name as command line arguments, or you can use the ini configuration file located in /etc/cloudflare-ddns/config.ini by passing no arguments at all. If you prefer, you can even use a configuration file in a custom location, using --config file.

Exit status

The cloudflare-ddns utility exits 0 on success, and >0 if an error occurs.

Examples

$ cloudflare-ddns
New IP: 149.20.4.15

Releases

2 releases since Debian 12 (Bookworm); the text changed 1 time.

  1. 12
  2. 13

--config until Debian 12 (Bookworm).

Authors

Andrea Pappacoda ⟨[email protected]⟩

From cloudflare-ddns 2.1.0-3 in Debian 13 (Trixie). Parsed by carta from the page's mdoc source.