Awesome Open Source
Awesome Open Source

Cloudflare dns-01 challenge hook bash for dehydrated

Semaphore CI Build Status
Circle CI CircleCI

If you like this project, or use it, please, star it!

Cloudflare Bash hook for dehydrated.

Docker version

For Docker version usage, see wiki

Why Cloudflare? What is this script?

If you cannot solve the HTTP-01 challenge, you need to solve the DNS-01 challenge. Details here.

With use of Cloudflare API (valid also on free plan!), this script will verify your domain putting a new record with a special token inside DNS zone. At the end of Let's Encrypt validation, that record will be deleted.

Depends on jq: sudo apt install -y jq

You only need:

  1. Register on Cloudflare (it works also on free plan)
  2. Change your domain DNS to manage them in Cloudflare (follow their guide).
  3. Run dehydrated with this hook (or run Docker image, see below)

You will find the certificates in the folder of dehydrated.

Classic mode: Prerequisites

cfhookbash has some prerequisites:

Classic mode: Setup

cd ~
git clone

Classic mode: Configuration

  1. Create a file domains.txt in the folder of dehydrated
  2. Put inside a list of domains that need certificates. Multiple (sub)domains on a single line will end up on a single certificate. *
  1. Move to the folder of cfhookbash
  2. Copy to
  3. Edit To get values:
Value Where to find Deprecated?
Zone ID Main page domain > Right Column > API section N
API Token Account > My Profile > API Tokens > Create Token > API token templates > "Edit zone DNS" N
Global API Key Account > My Profile > API Tokens > Api Keys > Global API Key Y, from 4.1.0

You can choose between using an API token and using your global API key. It is preferred to create a token, since tokens can be restricted to just the permission to edit DNS records in chosen zones (the DNS:Edit permission).

If you choose to use an API token, it must be filled into api_token. If you want to use your global API key, instead use global_api_key and email.

Global API key is deprecated and will be removed in future version.

Classic mode: Usage

Make a first run with CA="" placed in a config file in root directory of dehydrated.

./dehydrated -c -t dns-01 -k '${PATH_WHERE_YOU_CLONED_CFHOOKBASH}/cfhookbash/'

You will find the certificates inside ~/dehydrated/certs/[]. If you are using dehydrated with a config file and, you can speed up the requests for certificates with multiple (sub)domains by using HOOK_CHAIN="yes".

Classic mode: Post deploy

You can find in a recall to another file ( Here you can write different operation to execute AFTER every successfull challenge.

There is a stub file


cp && rm && nano

Classic mode: Cronjob

Remember that some action require sudo privilege (start and stop webserver, e.g.).

Best is run as root and running in cronjob specify full paths.

Following script will run every monday at 4AM and will create a log in home folder.

$ sudo crontab -e

0 4 * * 1 cd /home/<USER>/dehydrated && /home/<USER>/dehydrated/dehydrated -c -t dns-01 -k '/home/<USER>/cfhookbash/' >> /home/<USER>/cfhookbash-`date +\%Y-\%m-\%d-\%H-\%M-\%S`.log 2>&1

Update / upgrade

  • Move to folder where you downloaded it
  • Type git checkout master && git pull

Commons error messages

Error Solution
Could not route to /zones/dns_records, perhaps your object identifier is invalid? No route for that URI Check your Zone ID value. There probably is something wrong.
/home/YOUR_USER/cfhookbash/ line XX: jq: command not found Install jq (sudo apt install jq) and try again
{"code": 1001, "error": "method_not_allowed"} Update this script by running git pull


Everyone is welcome to contribute! See

Contributors, credits and bug discovery :)

  • YasharF
  • Ramblurr
  • Dav999-v
  • fallingcats
  • simondeziel

Inspired by

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
shell (10,204
bash (616
letsencrypt (140
cloudflare (109
bash-script (105