TL;DR jump to Installation
Spare you from manually updating 'A' records in your cloudfalre DNS provider when your external IP changes on your UDM.
This set of scripts is installed on devices with UbiOS, like the UniFi Dream Machine Pro (UDMP), and will
- check external IP address and compare it with the DNS 'A' record specified using cloudflare DNS Provider API
- update the DNS 'A' record in case it is different than the external IP assigned by your ISP (Internet Service Provider)
- Thanks to https://github.com/fire1ce/DDNS-Cloudflare-Bash for Cloudflare logic
- survive device reboots and firmware upgrades thanks to boostchicken's udm-utilities using its
on_boot.dextension.
This is valid as long as Ubiquiti does not change something in the 7E9B ir config. Use at your own risk, you have been warned.
In private installations, the UDM(P) is given an FQDN for remote access and this record must point to the ever changing IP address provided by an ISP.
- A UniFi Dream Machine (Pro),
- a registered domain where you have API access for udating 'A' records whenever the external IP changes.
A huge "Thank You" goes to
- boostchicken's udm-utilites: the way to run stuff on UbiOS while surviving upgrades and reboots
Confirmed to work on UniFi OS Version 1.11.4 and Network Version 7.0.23
sshinto your UDMP- Move to /data/ directory
- Clone the git project
- Make your adjustments to
ubios-ddns.env
# If git not present
apt-get install git
cd /data
git clone https://github.com/llaforest/ubios-ddns.git
cd ubios-ddns
chmod +x ubios-ddns.sh
# Edit the env file to set variables
vi ubios-ddns.env- Verify one last time the content of .env file
- Run the script for the first time
./ubios-ddns.shAdjust file ubios-ddns.env to your liking. You typically only need to touch environment variables DOMAIN, NAME, KEY and SECRET.
Calling the script for the first time will
- setup up the trigger for persistence over reboot / firmware upgrades
- establish a cron job to take care about your DNS updates
Here the script in on_boot.d will trigger execution of sh /mnt/data/ubios-ddns/ubios-ddns.sh, with a friendly delay of one minutes after boot.
- If running on UDMSE or UDR, replace
/mnt/databy/data - Remove the cron file from `/etc/cron.d´
- Remove the boot trigger from `/mnt/data/on_boot.d/´
Then, you can delete the script directory. As always, be careful with rm.
cd /mnt/data/
rm -irf ./ubios-ddns