Skip to content

Commit e2c56e4

Browse files
authored
docs(private-domains): document split DNS (same domain public and private) (#90)
1 parent 81a927d commit e2c56e4

1 file changed

Lines changed: 12 additions & 0 deletions

File tree

start-os/src/private-domains.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,3 +30,15 @@ Set StartOS as your router's primary DNS server. All routers support this featur
3030
3131
> [!TIP]
3232
> If your private domain is a real domain that you control, you can alternatively configure its DNS record at your registrar to resolve to your server's _LAN IP address_. In this case, the StartOS DNS server is not needed.
33+
34+
## Split DNS: the Same Domain, Public and Private
35+
36+
You can add the _same_ domain as both a [clearnet](clearnet.md) (public) domain on a StartTunnel gateway and a private domain on an Ethernet or WiFi gateway. StartOS serves it as split DNS:
37+
38+
- When you are on your LAN or connected over [VPN](inbound-vpn.md), StartOS resolves the domain to your server's local IP address, so traffic stays on your network at full LAN speed.
39+
- When you are away, the same domain resolves through public DNS to your StartTunnel gateway, so the service is reachable over the internet.
40+
41+
It's the same domain and the same TLS certificate either way, with no [hairpin routing](https://en.wikipedia.org/wiki/Hairpinning) (LAN traffic looping out to the gateway and back).
42+
43+
> [!TIP]
44+
> This is especially useful for services that embed their access URL in generated links, such as Nextcloud or Immich share links. Configure the service with the public domain so the links work for external recipients, and you'll still get direct LAN-speed access when you're home.

0 commit comments

Comments
 (0)