Traefik can't get a Let's Encrypt certificate
You run Proxy > Traefik > Staging or Production. Deployrr stops with a red error and your apps get no working HTTPS certificate. This page lists each error, what causes it and how to fix it.
For the normal Staging and Production steps, see Set up Traefik.
Symptoms
Section titled “Symptoms”Deployrr shows Monitoring traefik logs for progress (this can take up to 15 min).... It then stops with one of these errors:
Failed to find zoneUnable to obtain ACME certificateCould not find DNS validation TXT recordCannot get ACME client get directory. Possible DNS server issue.Getting certificate failed with error 429Each of these five comes with a hint line. For example, Failed to find zone adds “Possibly wrong Cloudflare API token. Ensure that your Scoped API Token has Zone/Zone/Read and Zone/DNS/Edit privileges.”
Unable to obtain ACME certificate adds two hints:
Possibly wrong Cloudflare API key. Ensure that your Scoped API Token has Zone/Zone/Read and Zone/DNS/Edit privileges.If you have an advanced firewall (UDM, OPNsense, etc.), disable Ad Blocking and suspicious activity blocking or bypass it for the Docker host.Three later messages mean the certificate never showed up:
Staging certificate could not be verified. Try re-running Deployrr.Real LetsEncrypt certificate could not be verified.Real LetsEncrypt certificate could not be verified after restart.You may also see one of these:
- The progress never ends. Deployrr keeps printing a joke or tip between dots (
... text ...) every 20 seconds. - Your browser shows a “Not Secure” or “certificate not trusted” warning.
Traefik asks Let’s Encrypt for a certificate that covers your domain and all its subdomains. To prove the domain is yours, it adds a temporary TXT record in Cloudflare and asks the public DNS servers 1.1.1.1 and 1.0.0.1 to confirm they can see it. Any break in that chain stops the certificate. The usual breaks are:
- The Cloudflare API token is wrong or has too few permissions.
- The domain is not in the Cloudflare account that the token belongs to.
- An old
_acme-challengeTXT record is still in Cloudflare, or DNS lookups from your server are blocked. - Your router or firewall blocks or redirects DNS from your server.
- You hit a Let’s Encrypt rate limit.
1. Find the error
Section titled “1. Find the error”-
Go to your Docker folder:
Terminal window cddWithout the Deployrr bash aliases, use
cd YOUR_DOCKER_FOLDER. ReplaceYOUR_DOCKER_FOLDERwith the path to your Docker folder. -
Search the Traefik log for the known errors:
Terminal window grep -iE "failed to find zone|No TXT record|server misbehaving|unable to obtain ACME|error: 429|too many certificates" logs/$HOSTNAME/traefik/traefik.log | tail -n 20Bash fills in
$HOSTNAMEfor you. If you seePermission denied, putsudoin front of the command. This is general Linux advice. For more on the log, see Read the Traefik logs.Staging clears the log each time it starts, so run this right after a failed try. Production moves the old log to
traefik_staging.logand starts a freshtraefik.log. After a Production failure, look in both files. -
Match what you found to this table. The log has Traefik’s own wording, not Deployrr’s.
Deployrr shows Search the log for Go to Failed to find zonefailed to find zoneFix the Cloudflare token, then Fix the domain or zone Unable to obtain ACME certificateUnable to obtain ACME certificateFix the Cloudflare token, then Fix DNS problems Could not find DNS validation TXT recordNo TXT record found at _acme-challengeFix old or unreachable TXT records Cannot get ACME client get directoryserver misbehavingFix DNS problems Getting certificate failed with error 429error: 429ortoo many certificatesWait out a rate limit The browser says Not Secure Nothing to search for Fix the browser warning The progress never ends, or the error is not in the list Lines with acmeorerrorIf the progress never ends
Fix the Cloudflare token
Section titled “Fix the Cloudflare token”Failed to find zone and Unable to obtain ACME certificate both point at the token first.
-
In Cloudflare, open My Profile > API Tokens. Use a user token, not an Account API Token.
-
Check that the token has both of these permissions:
- Zone / Zone / Read
- Zone / DNS / Edit
-
Check that the token can reach your domain’s zone. This is general Cloudflare advice, and the wording of the setting depends on your Cloudflare dashboard. In the token’s zone resources, include your domain or all zones.
-
If you need a new token, create it and copy it. To see the token made in Cloudflare, watch Traefik 3 guide: Cloudflare DNS records and scoped API token at 8:53 (manual Docker Compose setup; the Cloudflare steps are the same in v6).
-
Stop Traefik:
Terminal window sudo docker stop traefikPreparation checks that ports 443, 444, 80 and 81 are free. A running Traefik holds them. If you skip this step, Preparation fails with
Port 443 is occupied. This is needed for Traefik.and goes back to not done. Traefik usually still runs after a failed Staging. Staging starts it again.Your apps can’t be reached by their domain names until Staging finishes.
-
In Deployrr, open Proxy > Traefik > Preparation.
-
Select Yes in the first box.
-
If you see “It appears that Traefik preparation was already done. If you proceed, previous setup may be overwritten.”, press
Y. -
In the Traefik Secrets form, replace the old value in Cloudflare DNS API Token with the new token. Leave the Basic Auth Username as it is. If the form says “(Leave password blank to keep existing)”, you can leave Basic Auth Password blank to keep the old one. Without that line, there is no saved password, so type one. Blank stops with “Password cannot be empty.” If you type a new password, Deployrr asks for Confirm Basic Auth Password:.
-
Wait for “Traefik Preparation completed successfully”.
-
Go to Run Staging again.
To understand how Traefik uses the token, read UDMS part 18: Cloudflare DNS API token for Traefik (manual setup; for background only, not as steps to follow in Deployrr).
Fix the domain or zone
Section titled “Fix the domain or zone”Failed to find zone also happens when the token works but Cloudflare has no zone for your domain.
- Open the Cloudflare account that owns the token.
- Check that your domain is listed there and is active. This is general Cloudflare advice.
- In Deployrr, open Prerequisites and check Domain 1. It must be the same domain, with no typo.
- If the domain sits in a different Cloudflare account, make the token in that account. Then follow Fix the Cloudflare token to load it.
- Go to Run Staging again.
Fix old or unreachable TXT records
Section titled “Fix old or unreachable TXT records”You see:
Could not find DNS validation TXT recordTwo causes are common:
- A left-over
_acme-challengerecord from an earlier failed or interrupted run. This is general Cloudflare and Let’s Encrypt knowledge. - Blocked DNS lookups. Traefik can’t see the TXT record because DNS questions from your server are blocked or redirected. See Fix DNS problems.
To remove old records:
- In Cloudflare, select your domain.
- Open DNS > Records.
- Find every TXT record whose name starts with
_acme-challenge. - Delete each of them. Leave your other TXT records alone.
- Wait a minute.
- Go to Run Staging again.
Fix DNS problems
Section titled “Fix DNS problems”You see:
Cannot get ACME client get directory. Possible DNS server issue.Deployrr adds: “Check the DNS servers on your router. Confirm if the Docker host has internet access.”
The Traefik compose file that Deployrr creates uses 1.1.1.1 and 1.0.0.1 for the DNS check. Traefik asks them directly. It does not use the DNS server your router hands out. A router or firewall that redirects or blocks DNS from your server makes the check fail. It can also show up as Unable to obtain ACME certificate or as a missing TXT record.
Traefik also waits about 2 minutes before it checks DNS. A long wait with no error is normal.
- Check that the server reaches the internet.
- Check the DNS settings on your router.
- Look for a rule that redirects or blocks DNS (port 53) from your Docker host. OPNsense, UDM and other advanced firewalls are the usual cause. Follow Traefik staging fails on OPNsense, which also shows how to test
1.1.1.1from your server. - If the server lost DNS or internet after Prerequisites, see No internet on the server or in containers after setup.
- Go to Run Staging again.
Deployrr says you can override this error by turning on EXPERT mode in Settings > Mode. The box then reads “Expert mode ENABLED”. The override does not fix DNS. Deployrr checks the log about every 20 seconds, so while the same line is in the log, the override question (Expert mode enabled. Do you want to override (Y/y)?:) can come back again and again. Fix DNS instead.
Wait out a rate limit
Section titled “Wait out a rate limit”You see:
Getting certificate failed with error 429Deployrr adds: “You probably hit Let’s Encrypt rate limit. Wait at least 24 hours and retry.”
Let’s Encrypt limits how many certificates and failed validations you can have in a period. The next point is general Let’s Encrypt knowledge. Some limits reset within hours. Others take days. See the Let’s Encrypt rate limits page, which Deployrr also points to.
- Stop running Staging and Production. Each new try can count against the limit.
- Wait at least 24 hours.
- Fix any other cause on this page first, so the next try does not fail again.
- Go to Run Staging again.
To stay under the limit:
- Always run Staging before Production. Staging uses the Let’s Encrypt test server.
- When Production shows its “already done” warning and then asks “Reuse existing production SSL certificate?”, press
Yat both if the certificate works. Deployrr then skips asking for a new one. - Back up
acme.jsonbefore you run Staging again, and put it back instead of asking for a new production certificate.
Check the clock
Section titled “Check the clock”This is general Linux advice. Deployrr does not check it. If the server’s date and time are far off, certificate checks can fail.
-
Check the clock:
Terminal window timedatectl -
Look for
System clock synchronized: yes. -
If it says
no, turn on time sync:Terminal window sudo timedatectl set-ntp true -
Go to Run Staging again.
Fix the browser warning
Section titled “Fix the browser warning”After Staging, your browser shows “Not Secure”. Deployrr says this is normal, because Staging gets a test certificate. Browsers do not trust it. To see this happen, watch Deployrr 5 walkthrough: Traefik Staging and the Not Secure warning at 44:17 (shows Deployrr v5; menus differ in v6).
- Run Proxy > Traefik > Production.
- Wait for “Traefik Production Setup completed successfully”.
- Reload the page in a private window. This is general browser advice. It avoids a cached warning.
If Production fails, use the table in Find the error.
If the progress never ends
Section titled “If the progress never ends”Deployrr stops on the errors in the table. For anything else, it keeps waiting. It has no time-out at this step. If it is still running after 15 minutes, stop waiting and read the log yourself.
-
Open a second terminal on your server.
-
Follow the log:
Terminal window traefiklogsWithout the aliases, run this from your Docker folder:
Terminal window tail -f logs/$HOSTNAME/traefik/traefik.log -
Look for lines with
acmeorerror. See Read the Traefik logs. -
If you can’t tell the cause, ask on Discord and share the lines you found.
Run Staging again
Section titled “Run Staging again”Run Staging again after each fix. If your error came from Production and Staging already worked, you can run only Production (step 6).
-
Only if your current certificate works: copy the certificate file. Run this from your Docker folder:
Terminal window sudo cp -p appdata/traefik3/acme/acme.json appdata/traefik3/acme/acme.json.bakTo use it again later, see Put a saved certificate back.
-
Open Proxy > Traefik > Staging.
-
If you see “It appears that Traefik Staging/Production was already done. If you proceed, previous setup may be overwritten.”, press
Y. -
If you see “Reuse existing staging SSL certificate?”, press any key except
Yto get a fresh certificate. -
Wait for “Traefik Staging Setup completed successfully”.
-
Open Proxy > Traefik > Production.
-
If you see “It appears that Traefik Production was already done. If you proceed, previous setup may be overwritten.”, press
Yonly if you want a new certificate. If you then see “Reuse existing production SSL certificate?”, pressYto keep it, or any other key to get a new one. -
Wait for “Traefik Production Setup completed successfully”.
After a failed Staging, Deployrr usually starts fresh with no questions.
Put a saved certificate back
Section titled “Put a saved certificate back”Use this when Staging replaced a production certificate that worked, or when you set up Traefik again on a new server with the same Domain 1. A saved production certificate lets you skip a new request, so you stay under the Let’s Encrypt limit. You need a copy of acme.json from when the certificate worked, such as the acme.json.bak from Run Staging again.
-
Go to your Docker folder:
Terminal window cdd -
Check that the copy holds a production certificate:
Terminal window sudo grep -c "acme-v02.api.letsencrypt.org" appdata/traefik3/acme/acme.json.bak0means it holds a staging certificate or none. Deployrr can’t reuse it for Production. The certificate must also be for the domain you have in Domain 1. -
Make sure Staging shows
- DONEin the Traefik menu and Traefik is running. Production needs both. On a new server, run Preparation and Staging first. On a new server, Staging always starts with an emptyacme.json, so put the copy back after it. -
Copy the saved file back and set its permissions. Leave Traefik running:
Terminal window sudo cp -p appdata/traefik3/acme/acme.json.bak appdata/traefik3/acme/acme.jsonsudo chmod 600 appdata/traefik3/acme/acme.json -
Right away, open Proxy > Traefik > Production. Production restarts Traefik so it reads the file.
-
At “It appears that Traefik Production was already done. If you proceed, previous setup may be overwritten.”, press
Y. -
At “Reuse existing production SSL certificate?”, press
Y. Deployrr shows “Skipping certificate acquisition (reusing existing)…” and starts Traefik with the certificate. -
Wait for “Traefik Production Setup completed successfully”.
If Production doesn’t show the “already done” warning, Deployrr didn’t find a production certificate for Domain 1 in the file. It empties acme.json and asks Let’s Encrypt for a new certificate. The same happens if you see the warning but no reuse question after Y. Your acme.json.bak stays as it was.
Check it worked
Section titled “Check it worked”- Staging ends with “Traefik Staging Setup completed successfully”. Production ends with “Traefik Production Setup completed successfully”.
https://traefik.YOUR_DOMAINopens with a padlock after Production. ReplaceYOUR_DOMAINwith your domain.- The search from Find the error shows no new lines.

