khuedoan-homelab/docs/how-to-guides/alternate-dns-setup.md
Khue Doan 1405fadf1a refactor(docs): apply the Diátaxis framework
Squashed commit of the following:

commit 257867f196376df55fa0f57edbdf33967b1da04e
Author: Khue Doan <mail@khuedoan.com>
Date:   Sun Sep 18 16:45:42 2022 +0700

    refactor(docs): apply the Diátaxis framework
2022-09-19 02:40:07 +07:00

1.1 KiB

Alternate DNS setup

!!! info

    Skip this step if you already use the included Cloudflare setup

Before you can access the home page at https://home.example.com, you'll need to update your DNS config.

Some options for DNS config (choose one):

  • Change the DNS config at your domain registrar (already included and automated)
  • Change the DNS config in your router (also works if you don't own a domain)
  • Use nip.io (suitable for a test environment)

The default configuration is for Cloudflare DNS, but you can change the code to use other providers.

In your router

!!! tip

If you don't have a domain, you can use the `home.arpa` domain (according to [RFC-8375](https://datatracker.ietf.org/doc/html/rfc8375)).

You can add each subdomain one by one, or use a wildcard *.example.com and point it to the IP address of the load balancer. To acquire a list of subdomains and their addresses, use this command:

./scripts/get-dns-config

Use nip.io

Preconfigured in the dev branch.