Skip to content
SHC Docs

DNS module

Source: modules/dns/.

CLI
Subcommands0
HTTP endpointssee the route reference
Events emitted
Error codessee the error code reference
Service classesDNSService
Cross-module deps
modules/dns/
├── errors.go
├── service.go
├── types.go
└── providers/

Typed errors are catalogued in the error code reference with HTTP statuses and message templates.

The dns module owns per-stack DNS record management — creating, updating, and tearing down the DNS entries that expose a running stack to the outside world. Providers are pluggable (see dns/providers/ or equivalent): Cloudflare, Route53, a local stub, etc.

DNSService is called by the app lifecycle (install / uninstall / ingress changes) and by cluster-level DNS sync (see cluster/dns-provider-sync). It does not own ingress rules themselves (those live in app/ingress.go), nor HTTPS certificates (those come from the acme VApp on Traefik).