<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:media="http://search.yahoo.com/mrss/"><channel><title>cert-manager | A DevOps Blog</title><link>https://blog.bsdserver.nl/tag/cert-manager/</link><description>Hands-on DevOps and homelab content: Kubernetes clusters, self-hosted services, CI/CD pipelines and infrastructure as code, by Patrick de Ruiter of We Build Your Cloud.</description><language>en</language><image><url>https://blog.bsdserver.nl/images/app-icon.svg</url><title>A DevOps Blog</title><link>https://blog.bsdserver.nl/</link></image><lastBuildDate>Wed, 18 Nov 2026 09:00:00 +0100</lastBuildDate><atom:link href="https://blog.bsdserver.nl/tag/cert-manager/rss/" rel="self" type="application/rss+xml"/><ttl>60</ttl><item><title>Provisioning TLS Certificates with Traefik, cert-manager, and ACME-DNS in Kubernetes</title><link>https://blog.bsdserver.nl/provisioning-tls-certificates-with-traefik-cert-manager-and-acme-dns-in-kubernetes/</link><guid isPermaLink="false">693b526b79eb54000160a4d3</guid><dc:creator>Patrick de Ruiter</dc:creator><pubDate>Thu, 11 Dec 2025 23:23:23 +0000</pubDate><description>Introduction In a Kubernetes environment, having a robust and secure ingress controller is critical to properly route traffic to your applications.</description><category>Kubernetes</category><category>Traefik</category><category>cert-manager</category><category>Security</category><category>DevOps</category><media:content url="https://blog.bsdserver.nl/content/images/2026/01/tls-traefik-k8s-cert-manager-acme-dns.png" medium="image"/><content:encoded><![CDATA[<p>In Kubernetes, every Ingress with a hostname needs a TLS certificate, and doing that by hand does not scale. A DNS-01 challenge is the most flexible way to get Let&rsquo;s Encrypt certificates, but it usually means giving cert-manager API credentials that can change your whole DNS zone.</p>
<p>This post builds Traefik as the ingress controller, cert-manager to issue and renew certificates, and ACME-DNS: a small DNS server that only answers ACME challenges. cert-manager only gets credentials for ACME-DNS, never for your main DNS.</p>
<h2 id="why-this-stack">Why this stack? <a class="anchor" data-pagefind-ignore href="#why-this-stack" aria-label="Link to this section">#</a></h2>
<table>
	<thead>
			<tr>
					<th>Component</th>
					<th>Why</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td><strong>Traefik</strong></td>
					<td>Simple ingress controller; handles standard Ingress objects and its own CRDs, applies changes without restarts.</td>
			</tr>
			<tr>
					<td><strong>cert-manager</strong></td>
					<td>Issues and renews certificates via ACME, stores them as Kubernetes secrets.</td>
			</tr>
			<tr>
					<td><strong>ACME-DNS</strong></td>
					<td>Solves DNS-01 challenges without credentials for your main DNS zone.</td>
			</tr>
	</tbody>
</table>
<h3 id="when-to-use-it">When to use it <a class="anchor" data-pagefind-ignore href="#when-to-use-it" aria-label="Link to this section">#</a></h3>
<ul>
<li><strong>Use it</strong> when you need DNS-01 (wildcards, hosts not reachable from the internet) and your DNS provider has no API, no cert-manager support, or only all-or-nothing API keys.</li>
<li><strong>Skip it</strong> when HTTP-01 works for you, or your DNS provider has a scoped API token that cert-manager supports directly. ACME-DNS is one more public DNS server to run.</li>
</ul>
<h2 id="architecture-overview">Architecture Overview <a class="anchor" data-pagefind-ignore href="#architecture-overview" aria-label="Link to this section">#</a></h2>
<table>
	<thead>
			<tr>
					<th>Component</th>
					<th>Runs on</th>
					<th>Job</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Traefik</td>
					<td>Cluster, namespace <code>traefik</code></td>
					<td>Ingress controller: terminates TLS with the certificate secret, routes to services.</td>
			</tr>
			<tr>
					<td>cert-manager</td>
					<td>Cluster, namespace <code>cert-manager</code></td>
					<td>Watches Certificate resources, runs the ACME order, writes the TLS secret.</td>
			</tr>
			<tr>
					<td>ACME-DNS</td>
					<td>Cluster, namespace <code>acme-dns</code></td>
					<td>Authoritative DNS for <code>auth.example.com</code> (public, port 53); HTTP API for updating TXT records (cluster-internal).</td>
			</tr>
			<tr>
					<td>Main DNS</td>
					<td>Your DNS provider</td>
					<td>Delegates <code>auth.example.com</code> to ACME-DNS; CNAMEs <code>_acme-challenge.example.com</code> into it.</td>
			</tr>
	</tbody>
</table>
<p>The flow: a Certificate is created → cert-manager asks Let&rsquo;s Encrypt for an order → writes the challenge TXT record into ACME-DNS through its API → Let&rsquo;s Encrypt looks up <code>_acme-challenge.example.com</code> → follows the CNAME to ACME-DNS → validates → cert-manager stores the certificate in a secret → Traefik serves it.</p>
<h2 id="1-installing-traefik">1. Installing Traefik <a class="anchor" data-pagefind-ignore href="#1-installing-traefik" aria-label="Link to this section">#</a></h2>
<p>Traefik is the ingress controller that will serve the certificates. The Helm chart gives it a LoadBalancer Service for incoming traffic.</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">helm repo add traefik https://helm.traefik.io/traefik
</span></span><span class="line"><span class="cl">helm repo update
</span></span><span class="line"><span class="cl">kubectl create namespace traefik
</span></span><span class="line"><span class="cl">helm install traefik traefik/traefik --namespace traefik --set service.spec.type<span class="o">=</span>LoadBalancer
</span></span></code></pre></div><p>Current chart versions validate their values against a schema, and the old <code>service.type</code> key is rejected with <code>at '/service': additional properties 'type' not allowed</code>. The Service type now lives under <code>service.spec</code>. <code>LoadBalancer</code> is the default anyway.</p>
<p>Check that the pod runs and the Service has an external IP:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">kubectl get pods -n traefik
</span></span><span class="line"><span class="cl">kubectl get svc -n traefik
</span></span></code></pre></div><h2 id="2-installing-cert-manager">2. Installing cert-manager <a class="anchor" data-pagefind-ignore href="#2-installing-cert-manager" aria-label="Link to this section">#</a></h2>
<p>cert-manager runs the ACME orders and renewals. <code>crds.enabled=true</code> installs its CRDs (Certificate, ClusterIssuer, &hellip;) together with the chart.</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">helm repo add jetstack https://charts.jetstack.io
</span></span><span class="line"><span class="cl">helm repo update
</span></span><span class="line"><span class="cl">kubectl create namespace cert-manager
</span></span><span class="line"><span class="cl">helm install cert-manager jetstack/cert-manager --namespace cert-manager --set crds.enabled<span class="o">=</span><span class="nb">true</span>
</span></span></code></pre></div><p>Check that the pods are running:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">kubectl get pods -n cert-manager
</span></span></code></pre></div><h2 id="3-installing-acme-dns">3. Installing ACME-DNS <a class="anchor" data-pagefind-ignore href="#3-installing-acme-dns" aria-label="Link to this section">#</a></h2>
<p>ACME-DNS answers DNS queries for one subdomain and lets clients update TXT records in it through an HTTP API. Each registered account can only update its own record.</p>
<p>ACME-DNS reads its settings from <code>/etc/acme-dns/config.cfg</code> and won&rsquo;t start without it (<code>configuration file not found</code>); there are no environment variables for this. The manifest below:</p>
<ul>
<li><strong>ConfigMap</strong>: the config file, mounted at <code>/etc/acme-dns</code>.</li>
<li><strong>PersistentVolumeClaim</strong>: the SQLite database, which holds the registered accounts. Losing it breaks every CNAME you created.</li>
<li><strong>Deployment</strong>: one replica, <code>Recreate</code> strategy, so the old pod releases the volume before the new one starts.</li>
<li><strong>Service <code>acme-dns-dns</code></strong>: LoadBalancer, DNS on port 53 UDP and TCP, reachable from the internet.</li>
<li><strong>Service <code>acme-dns</code></strong>: ClusterIP, the HTTP API, only reachable inside the cluster.</li>
</ul>
<p>Key settings in <code>config.cfg</code>:</p>
<table>
	<thead>
			<tr>
					<th>Setting</th>
					<th>What it does</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td><code>domain</code>, <code>nsname</code></td>
					<td>The subdomain ACME-DNS is authoritative for, and its name server name.</td>
			</tr>
			<tr>
					<td><code>records</code></td>
					<td>Static records it serves: its own A and NS records. Fill in the public IP.</td>
			</tr>
			<tr>
					<td><code>protocol = &quot;both&quot;</code></td>
					<td>Answer DNS over UDP and TCP.</td>
			</tr>
			<tr>
					<td><code>[api] tls = &quot;none&quot;</code></td>
					<td>Plain HTTP; acceptable because the API Service is cluster-internal.</td>
			</tr>
			<tr>
					<td><code>disable_registration = false</code></td>
					<td>Anyone who reaches the API can register an account. Needed for the registration step below.</td>
			</tr>
	</tbody>
</table>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">kubectl create namespace acme-dns
</span></span></code></pre></div><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">ConfigMap</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns-config</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">data</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">config.cfg</span><span class="p">:</span><span class="w"> </span><span class="p">|</span><span class="sd">
</span></span></span><span class="line"><span class="cl"><span class="sd">    [general]
</span></span></span><span class="line"><span class="cl"><span class="sd">    listen = &#34;0.0.0.0:53&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd">    protocol = &#34;both&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd">    domain = &#34;auth.example.com&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd">    nsname = &#34;ns1.auth.example.com&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd">    nsadmin = &#34;admin.example.com&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd">    records = [
</span></span></span><span class="line"><span class="cl"><span class="sd">        &#34;auth.example.com. A &lt;PUBLIC_IP_OF_ACME_DNS&gt;&#34;,
</span></span></span><span class="line"><span class="cl"><span class="sd">        &#34;ns1.auth.example.com. A &lt;PUBLIC_IP_OF_ACME_DNS&gt;&#34;,
</span></span></span><span class="line"><span class="cl"><span class="sd">        &#34;auth.example.com. NS ns1.auth.example.com.&#34;,
</span></span></span><span class="line"><span class="cl"><span class="sd">    ]
</span></span></span><span class="line"><span class="cl"><span class="sd">    [database]
</span></span></span><span class="line"><span class="cl"><span class="sd">    engine = &#34;sqlite&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd">    connection = &#34;/var/lib/acme-dns/acme-dns.db&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd">    [api]
</span></span></span><span class="line"><span class="cl"><span class="sd">    ip = &#34;0.0.0.0&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd">    port = &#34;80&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd">    tls = &#34;none&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd">    disable_registration = false
</span></span></span><span class="line"><span class="cl"><span class="sd">    corsorigins = [&#34;*&#34;]
</span></span></span><span class="line"><span class="cl"><span class="sd">    use_header = false
</span></span></span><span class="line"><span class="cl"><span class="sd">    header_name = &#34;X-Forwarded-For&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd">    [logconfig]
</span></span></span><span class="line"><span class="cl"><span class="sd">    loglevel = &#34;info&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd">    logtype = &#34;stdout&#34;
</span></span></span><span class="line"><span class="cl"><span class="sd">    logformat = &#34;text&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nn">---</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">PersistentVolumeClaim</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns-data</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">spec</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">accessModes</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">&#34;ReadWriteOnce&#34;</span><span class="p">]</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">resources</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">requests</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">storage</span><span class="p">:</span><span class="w"> </span><span class="l">100Mi</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nn">---</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">apps/v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">Deployment</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">spec</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">replicas</span><span class="p">:</span><span class="w"> </span><span class="m">1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">strategy</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l">Recreate</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">selector</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">matchLabels</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">app</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">template</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">labels</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">app</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">spec</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">containers</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l">joohoi/acme-dns:v2.0.2</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">ports</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span>- <span class="nt">containerPort</span><span class="p">:</span><span class="w"> </span><span class="m">53</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">protocol</span><span class="p">:</span><span class="w"> </span><span class="l">UDP</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span>- <span class="nt">containerPort</span><span class="p">:</span><span class="w"> </span><span class="m">53</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">protocol</span><span class="p">:</span><span class="w"> </span><span class="l">TCP</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span>- <span class="nt">containerPort</span><span class="p">:</span><span class="w"> </span><span class="m">80</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">protocol</span><span class="p">:</span><span class="w"> </span><span class="l">TCP</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">volumeMounts</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">config</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">mountPath</span><span class="p">:</span><span class="w"> </span><span class="l">/etc/acme-dns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">readOnly</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">data</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">mountPath</span><span class="p">:</span><span class="w"> </span><span class="l">/var/lib/acme-dns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">volumes</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">config</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">configMap</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns-config</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">data</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">persistentVolumeClaim</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">claimName</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns-data</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nn">---</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="c"># DNS, reachable from the internet</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">Service</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns-dns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">spec</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l">LoadBalancer</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">selector</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">app</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">ports</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">dns-udp</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="m">53</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">protocol</span><span class="p">:</span><span class="w"> </span><span class="l">UDP</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">dns-tcp</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="m">53</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">protocol</span><span class="p">:</span><span class="w"> </span><span class="l">TCP</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nn">---</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="c"># HTTP API, cluster-internal only</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">Service</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">spec</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">selector</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">app</span><span class="p">:</span><span class="w"> </span><span class="l">acme-dns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">ports</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">api</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">port</span><span class="p">:</span><span class="w"> </span><span class="m">80</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">protocol</span><span class="p">:</span><span class="w"> </span><span class="l">TCP</span><span class="w">
</span></span></span></code></pre></div><p><code>&lt;PUBLIC_IP_OF_ACME_DNS&gt;</code> is the external IP the <code>acme-dns-dns</code> LoadBalancer gets.</p>
<h2 id="4-dns-configuration-for-subdomain-delegation">4. DNS Configuration for Subdomain Delegation <a class="anchor" data-pagefind-ignore href="#4-dns-configuration-for-subdomain-delegation" aria-label="Link to this section">#</a></h2>
<p>Let&rsquo;s Encrypt looks for the challenge at <code>_acme-challenge.example.com</code> in your main DNS. You delegate a subdomain (<code>auth.example.com</code>) to ACME-DNS once, and point <code>_acme-challenge</code> at it with a CNAME per domain.</p>
<p>Why a CNAME and not an NS record on <code>_acme-challenge.example.com</code> itself: ACME-DNS only answers for names under its own domain, so it would answer NXDOMAIN.</p>
<p><strong>In your main DNS</strong>, delegate <code>auth.example.com</code> to ACME-DNS, with a glue record:</p>
<pre tabindex="0"><code>auth.example.com.             IN NS    ns1.auth.example.com.
ns1.auth.example.com.         IN A     &lt;PUBLIC_IP_OF_ACME_DNS&gt;
</code></pre><p><strong>Register an account</strong> for each domain you want certificates for. The API is only reachable inside the cluster, so use a port-forward:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">kubectl -n acme-dns port-forward svc/acme-dns 8080:80 <span class="p">&amp;</span>
</span></span><span class="line"><span class="cl">curl -s -X POST http://localhost:8080/register &gt; acme-dns-account.json
</span></span><span class="line"><span class="cl">cat acme-dns-account.json
</span></span></code></pre></div><p>The response contains a <code>username</code>, <code>password</code> and a <code>fulldomain</code> such as <code>4411d03a-5aaa-419b-9bc9-a5d55a94c8df.auth.example.com</code>.</p>
<p><strong>In your main DNS</strong>, point the challenge name at that <code>fulldomain</code>:</p>
<pre tabindex="0"><code>_acme-challenge.example.com.  IN CNAME 4411d03a-5aaa-419b-9bc9-a5d55a94c8df.auth.example.com.
</code></pre><h2 id="5-configuring-cert-manager-for-acme-dns">5. Configuring cert-manager for ACME-DNS <a class="anchor" data-pagefind-ignore href="#5-configuring-cert-manager-for-acme-dns" aria-label="Link to this section">#</a></h2>
<p>cert-manager needs the account credentials to update the TXT record. It expects them as a JSON map keyed by the domain name. For a ClusterIssuer, the secret goes in the <code>cert-manager</code> namespace:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">jq <span class="s1">&#39;{&#34;example.com&#34;: .}&#39;</span> acme-dns-account.json &gt; account.json
</span></span><span class="line"><span class="cl">kubectl -n cert-manager create secret generic acmedns-secret --from-file<span class="o">=</span>account.json
</span></span></code></pre></div><p>A ClusterIssuer can issue certificates in every namespace. The important fields:</p>
<ul>
<li><code>server</code>: the Let&rsquo;s Encrypt production endpoint. Use the staging URL while testing to avoid rate limits.</li>
<li><code>privateKeySecretRef</code>: where cert-manager stores the Let&rsquo;s Encrypt account key; created automatically.</li>
<li><code>acmeDNS.host</code>: the cluster-internal API Service from step 3.</li>
<li><code>accountSecretRef</code>: the secret you just created.</li>
</ul>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">cert-manager.io/v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">ClusterIssuer</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">letsencrypt-acmedns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">spec</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">acme</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">server</span><span class="p">:</span><span class="w"> </span><span class="l">https://acme-v02.api.letsencrypt.org/directory</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">email</span><span class="p">:</span><span class="w"> </span><span class="l">your-email@example.com</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">privateKeySecretRef</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">acmedns-issuer-account-key</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">solvers</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="nt">dns01</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">acmeDNS</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">host</span><span class="p">:</span><span class="w"> </span><span class="l">http://acme-dns.acme-dns.svc.cluster.local</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">accountSecretRef</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">acmedns-secret</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l">account.json</span><span class="w">
</span></span></span></code></pre></div><h3 id="requesting-a-certificate">Requesting a Certificate <a class="anchor" data-pagefind-ignore href="#requesting-a-certificate" aria-label="Link to this section">#</a></h3>
<p>A Certificate resource tells cert-manager which names to cover and which secret to write. cert-manager renews it before it expires.</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">cert-manager.io/v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">Certificate</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">example-com-tls</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l">default</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">spec</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">secretName</span><span class="p">:</span><span class="w"> </span><span class="l">example-com-tls-secret</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">issuerRef</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">letsencrypt-acmedns</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">ClusterIssuer</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">dnsNames</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span>- <span class="l">example.com</span><span class="w">
</span></span></span></code></pre></div><h2 id="6-using-tls-in-traefik">6. Using TLS in Traefik <a class="anchor" data-pagefind-ignore href="#6-using-tls-in-traefik" aria-label="Link to this section">#</a></h2>
<p>Traefik picks up the certificate from the secret named in the Ingress <code>tls</code> section. The Ingress must be in the same namespace as the secret.</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">networking.k8s.io/v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">Ingress</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">example-com-ingress</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">spec</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">ingressClassName</span><span class="p">:</span><span class="w"> </span><span class="l">traefik</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">tls</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="nt">hosts</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">example.com</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">secretName</span><span class="p">:</span><span class="w"> </span><span class="l">example-com-tls-secret</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">rules</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="nt">host</span><span class="p">:</span><span class="w"> </span><span class="l">example.com</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">http</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">paths</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span>- <span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l">/</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">pathType</span><span class="p">:</span><span class="w"> </span><span class="l">Prefix</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">backend</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">              </span><span class="nt">service</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">                </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">my-service</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">                </span><span class="nt">port</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">                  </span><span class="nt">number</span><span class="p">:</span><span class="w"> </span><span class="m">80</span><span class="w">
</span></span></span></code></pre></div><h2 id="troubleshooting">Troubleshooting <a class="anchor" data-pagefind-ignore href="#troubleshooting" aria-label="Link to this section">#</a></h2>
<p>Follow the chain: Certificate → Order → Challenge. <code>kubectl describe</code> on each shows where it stops.</p>
<table>
	<thead>
			<tr>
					<th>Symptom</th>
					<th>Cause / fix</th>
			</tr>
	</thead>
	<tbody>
			<tr>
					<td>Helm: <code>additional properties 'type' not allowed</code></td>
					<td>Use <code>service.spec.type</code> with current Traefik charts.</td>
			</tr>
			<tr>
					<td>ACME-DNS pod crashes with <code>configuration file not found</code></td>
					<td>ConfigMap not mounted at <code>/etc/acme-dns</code>.</td>
			</tr>
			<tr>
					<td>Challenge stays pending</td>
					<td>Check <code>dig TXT _acme-challenge.example.com</code>: the CNAME and the <code>auth.example.com</code> delegation must both resolve from the internet.</td>
			</tr>
			<tr>
					<td>ACME-DNS returns NXDOMAIN</td>
					<td>You delegated <code>_acme-challenge</code> with NS instead of a CNAME.</td>
			</tr>
			<tr>
					<td>Issuer cannot find credentials</td>
					<td>The <code>account.json</code> key must be the domain name, and the secret must be in <code>cert-manager</code> for a ClusterIssuer.</td>
			</tr>
	</tbody>
</table>
<h2 id="security-considerations">Security Considerations <a class="anchor" data-pagefind-ignore href="#security-considerations" aria-label="Link to this section">#</a></h2>
<ul>
<li><strong>API stays internal</strong>: with <code>disable_registration = false</code>, anyone reaching the API can register accounts. Never expose the <code>acme-dns</code> Service.</li>
<li><strong>Scoped credentials</strong>: an ACME-DNS account can only update its own TXT record. A leaked <code>acmedns-secret</code> cannot change your main zone.</li>
<li><strong>Back up the database</strong>: the PVC holds the accounts your CNAMEs depend on.</li>
</ul>
<h2 id="automate-it">Automate it <a class="anchor" data-pagefind-ignore href="#automate-it" aria-label="Link to this section">#</a></h2>
<p>The Ansible roles and Terraform code that build this setup are on GitHub:
<a href="https://github.com/pderuiter/blog-cert-manager-acme-dns" rel="noopener">pderuiter/blog-cert-manager-acme-dns</a>. It creates a single-node k3s cluster with Traefik, cert-manager and ACME-DNS, registers the ACME-DNS accounts, creates the ClusterIssuer, and prints the NS, glue and CNAME records for your main DNS. Run <code>terraform apply</code>, then <code>ansible-playbook site.yml</code>.</p>
<h2 id="conclusion">Conclusion <a class="anchor" data-pagefind-ignore href="#conclusion" aria-label="Link to this section">#</a></h2>
<p>Each part has one job:</p>
<ol>
<li><strong>Traefik</strong> routes traffic and serves the certificates</li>
<li><strong>cert-manager</strong> issues and renews them</li>
<li><strong>ACME-DNS</strong> solves the DNS-01 challenges, with minimal exposure of your main DNS zone</li>
</ol>
<p>Add a domain by registering an ACME-DNS account, adding its CNAME and adding it to the secret.</p>
]]></content:encoded></item></channel></rss>