diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md index 2c5bd5e2..74d70640 100644 --- a/docs/SUMMARY.md +++ b/docs/SUMMARY.md @@ -10,6 +10,7 @@ - [Prerequisites](./deployment/prerequisites.md) - [Configuration](./deployment/configuration.md) - [Deploy the homelab](./deployment/deployment.md) + - [DNS setup](./deployment/dns.md) - [Troubleshooting](./troubleshooting/README.md) - [PXE boot](./troubleshooting/pxe_boot.md) - [Reference](./reference/README.md) diff --git a/docs/deployment/dns.md b/docs/deployment/dns.md new file mode 100644 index 00000000..22ff4b45 --- /dev/null +++ b/docs/deployment/dns.md @@ -0,0 +1,30 @@ +# DNS setup + +Some options for DNS config: + +- Change the DNS config in your router +- Run your own DNS server in the cluster +- Change the DNS config in your domain registrar + +For example here is my set up using the third option with Cloudflare, automated using Terraform: + +```hcl +resource "cloudflare_record" "homelab_records" { + for_each = toset([ + "*.knative", + "argocd", + "dex", + "git", + "grafana", + "tekton", + "vault", + # etc. + ]) + + zone_id = cloudflare_zone.khuedoan_com.id + type = "A" + name = each.key + value = "192.168.1.150" + ttl = 1 # Auto +} +```