Installation

Standalone binaries

Pre-compiled binaries bundle the script’s own dependencies (Bash, curl, jq); the self-extracting launcher only relies on basic system tools (tar, and PowerShell on Windows) to unpack itself.

1. Download the latest release for your platform from the Releases page:

   • Linux: cf-updater-linux-x86_64 (Intel/AMD) or cf-updater-linux-aarch64 (ARM/Raspberry Pi)
   • macOS: cf-updater-macos-x86_64 (Intel) or cf-updater-macos-aarch64 (Apple Silicon)
   • Windows: cf-updater-windows-x86_64.exe

2. Make it executable (Linux/macOS):

   chmod +x cf-updater-linux-x86_64

3. Run it from the directory that contains your cloudflare-dns.yaml, or pass the config path as an argument:

   ./cf-updater-linux-x86_64 /path/to/cloudflare-dns.yaml

From source

Requirements:

• Bash 4.0+
• curl (wget or PowerShell are used as fallbacks)
• jq — strongly recommended; without it a slower, limited parser is used

git clone https://github.com/jmrplens/Cloudflare-DNS-Updater.git
cd Cloudflare-DNS-Updater
cp config.example.yaml cloudflare-dns.yaml
chmod 600 cloudflare-dns.yaml
./cloudflare-dns-updater.sh

The launcher looks for cloudflare-dns.yaml next to itself.

Protect your token

cloudflare-dns.yaml contains your Cloudflare API token. Keep it readable only by its owner (chmod 600); the program warns at startup if other users can read it.