Files
Alfred Göppel a5ea542bfb Update setup-guide.md
Signed-off-by: Alfred Göppel <43101280+alfi0812@users.noreply.github.com>
2026-01-19 16:52:57 +01:00

53 lines
1.7 KiB
Markdown

---
title: How-To
---
This guide will help you go through the steps to use Cloudflareddns to update your dynamic IP along with your entire deployment, so that even if you change IP your domain will point to the right address.
## Prerequisites
This guide assumes you've followed our [clusterissuer guide](/truecharts/charts/stable/clusterissuer/how-to) with your domain and done the configuration for your DNS on Cloudflare
The recommended way is to setup CNAMEs for your subdomains (charts) and keep your A record pointed to your base domain, such as below
![cloudflare-dns](./img/cloudflare-dns.png)
## Create an API Token
In case you haven't created an api token yet, create one as follows.
In your profile, go to **API Tokens** and click **Create Token**, then select **Use Template** for **Edit zone DNS**.
Permissions
- Zone - DNS - Edit
![cloudflare-token](./img/cloudflare-token.png)
## Cloudflareddns Chart Setup
Use the API Token previously created for the **api_token** field.
- Change **domain** to your DNS Zone A record (yourdomain.com)
- Change **record** to 'A' if you're only changing your main domain
An example configuration could look like that:
```yaml
values:
workload:
main:
podSpec:
containers:
main:
env:
UPDATE_IPV6: false
DETECTION_MODE: "dig-whoami.cloudflare"
LOG_LEVEL: 3
CF_APITOKEN: ${CLOUDFLARE_TOKEN}
CF_HOSTS: "minecraft.${DOMAIN_0},wireguard.${DOMAIN_1}"
INTERVAL: 300
```
If you're using or changing specific A records or CNAMEs you may want to refer to the upstream documentation for more examples [here](https://hotio.dev/containers/cloudflareddns/))