CLOUDFLARE-DDNS(1)

πŸ“¦
version 2.1.0 Β· 2 versions
, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’– CLOUDFLARE-DDNS(1) β€” the cloudflare-ddns manual, but make it cute πŸ’–

ok so bestie, this is cloudflare-ddns, a page from the General Commands Manual section 1. Sit down, grab a strawberry πŸ“, and let's get you fluent.


✨ NAME ✨

cloudflare-ddns β€” dynamically update a DNS record

like. it updates your DNS record. dynamically. that's the whole job. slay.


🌸 SYNOPSIS 🌸

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

that's it. that's the whole vibe check. πŸ‘‘


πŸ¦‹ DESCRIPTION πŸ¦‹

okay so cloudflare-ddns is a tool that can be used to dynamically update a DNS record using Cloudflare's API. no cap. that's literally what it does.

This tool is a oneshot program: you run it, it updates the DNS record, and it terminates. it does its little task and then it's gone, main character energy but make it brief ✨. To make it run periodically you could use a systemd timer or a cron job. set it and forget it, periodt.

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. that's it, that's the only permission it's asking for, lowkey minimal πŸŽ€.

You can run cloudflare-ddns in two different ways, and honestly pick whichever one is giving more:

  • 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. so many options, we love a flexible icon πŸ’….


πŸ’€ EXIT STATUS πŸ’€

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

so like, 0 = we ate, >0 = something is wrong and we're crying in the club 😭.


🌈 EXAMPLES 🌈

$ cloudflare-ddns
New IP: 149.20.4.15

look at her go. no notes. iconic. πŸ”₯


🧚 SEE ALSO 🧚

your two besties for making this thing actually repeat itself. iykyk. 🫢


πŸ‘‘ AUTHORS πŸ‘‘

Andrea Pappacoda <andrea@pappacoda.it>


and that's the whole page, bestie!! πŸ’œ this one's from the Debian crew, dated 2022-08-22, and it's page CLOUDFLARE-DDNS(1) of the General Commands Manual β€” mwah, go update something dynamically, you've got this. πŸŽ€βœ¨