Set up Dynamic DNS with Cloudflare on Synology DSM 6


In the Synology DSM there are several DDNS services available. Unfortunately Cloudflare isn’t among them. But there is a way to get it up and running thanks to joshuaavalon at github.

First of all you need a domain name already using cloudflare. If you don’t, there might not be any reason for you to read this tutorial.


  1. Download and install script to NAS
  2. Get needed info from Cloudflare
  3. Update the script
  4. Activate DDNS in DSM

1. Download and install script to NAS

a. log in to your nas with SSH as admin. If SSH isn’t activated, do the following

  • Login to your DSM
  • Go to Control Panel > Terminal & SNMP > Enable SSH service
  • Open a terminal of choice and type ssh admin@NASHOSTNAME or IP

b. Download from joshuavalons githup repository to /sbin/ by entering the following command

sudo wget -O /sbin/

c. Change permissions of file

sudo chmod +x /sbin/

d. Add to synology by pasting the following lines into your terminal and press enter.

sudo echo "[Cloudflare]">>/etc.defaults/ddns_provider.conf
sudo echo " modulepath=/sbin/">>/etc.defaults/ddns_provider.conf
sudo echo " queryurl=">>/etc.defaults/ddns_provider.conf

2. Get needed info from Cloudflare

a. Log in to your cloudflare account and select the domain you intend to use and go to “overview”.
b. Copy your “Zone ID:”
c. Copy your API key by selecting “Get your API key”


d. Edit the script below by replacing keys with the keys your retrieved earlier.
e. Get your record ID by pasting the updated script in your terminal and press enter.

curl -X GET "" \
   -H "X-Auth-Email:" \
   -H "X-Auth-Key: xxxxxxxxxxxxxAPI-KEYxxxxxxxxxxxxxxxx" \
   -H "Content-Type: application/json"

The record ID is the first ID listed in the output {“result”:[{“id”:”xxxxxxxxxxxRECORD-IDxxxxxxxxxxxxxxx“..


3. Update the script

a. You now need to update /sbin/ with the paramaters you have retrieved. I do this with Nano because vim doesn’t make sense =)
If you don’t have nano installed you can do it by installing entware or optware. I recommendthe following guide
in the script scroll down and edit the followin paramaters.

# CloudFlare Config

4 Activate DDNS in DSM

a. Log in to DSM, open the control panel and go to External Access and click Add under DDNS

b. Choose Cloudflare as service and enter your details in the DDNS window. Your password is your API-KEY and not your cloudflare password.


You should be all set! If not, don’t hesitate to comment and I’ll see if I can help.

Oh and as usual, if something breaks, blame the bad guys..



  1. I am sure I am not the only one, you’ve mentionned to comment if not… can I say that I wanted to thanks you a lot and add that it worked PERFECTLY ?
    This tutorial is just top because only few of the other mentionned so clearly how to make it match with DDNS on synology !
    Thanks a lot, a lot, a lot :)

    • Sorry you’re experiencing trouble. Please check step 1:D and make sure there weren’t any additional line-breaks or characters entered (This can also happen if you copied the code from above. Copying from a browser to the terminal can create mischief every now and then) The only thing I can think of is if something broke the etc.defaults/ddns_provider.conf -file. That’s were all the ddns-providers are listed. Check the file and make sure it’s “okay”. If it’s corrupted I can send you an original. The setup above should still be working. Hope that helps

  2. Hi!. First thanks for this script and sorry for my bad English.
    When I executed the script say this error.

    {“success”:false,”errors”:[{“code”:9106,”message”:”Missing X-Auth-Email header”},{“code”:9107,”message”:”Missing X-Auth-Key header”}],”messages”:[],”result”:null}

    But when I configured in the Synology the status is normal.

    • Hey Luis,
      As long as it’s working, that error code is most likely a result of an update in the cloudflare API. This script is quite old but I’m sure cloudflare will stay backward-compatible for a while longer. If it stops working we’ll have to update the script according to the new api. Let’s hope it won’t be needed =)

  3. admin@SLEESTAK:~$ sudo echo “[Cloudflare]”>>/etc.defaults/ddns_provider.conf
    -sh: /etc.defaults/ddns_provider.conf: Permission denied

    Was going well until this I get permission denied. I had to login as admin and “sudo -i” enter admin password again and I got the root prompt. After this no issues!

    Will this get replaced each time i update DSM?

Leave a Reply

Your email address will not be published.


This site uses Akismet to reduce spam. Learn how your comment data is processed.