Dynamic DNS using DigitalOcean's DNS Services
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Alper Kanat 9d6d48e00d
Merge pull request #22 from lawtancool/master
2 years ago
Dockerfile Update Dockerfile 2 years ago
README.md Add REMOVE_DUPLICATES env variable 2 years ago
dyndns.sh Fix indentation 2 years ago


Dynamic DNS using DigitalOcean's DNS Services

A script that pushes the public IP address of the running machine to DigitalOcean's DNS API's. It requires an existing A record to update. The resulting container image is roughly around 7 MB (thanks to Alpine Linux).


Assuming you already have a DigitalOcean account and your domain associated with it. Just add an A record with desired name and IP address. That's it!


Pick one of the options below using the following settings:

  • DIGITALOCEAN_TOKEN: The token you generate in DigitalOcean's API settings.
  • DOMAIN: The domain your subdomain is registered at. (i.e. foo.com for home.foo.com)
  • NAME: Subdomain to use. (name in A record) (i.e. home for home.foo.com). Multiple subdomains must be separated by semicolons ;
  • SLEEP_INTERVAL: Polling time in seconds. (default: 300)
  • REMOVE_DUPLICATES: If set to "true", removes extra DNS records if more than one A record is found on a subdomain. Note that if this is not enabled, the script will NOT update subdomains with more than one A record (default: false)
$ docker pull tunix/digitalocean-dyndns
$ docker run -d --name dyndns \
    -e DIGITALOCEAN_TOKEN="your_token_here" \
    -e DOMAIN="yourdomain.com" \
    -e NAME="subdomain" \
    -e REMOVE_DUPLICATES="true" \


You can also create a cronjob using below command:

$ DIGITALOCEAN_TOKEN="your_token_here" DOMAIN="yourdomain.com" NAME="subdomain" SLEEP_INTERVAL=2 ./dyndns.sh