Subdomain Guides
Configure Hydrodactyl subdomains, DNS providers, and allocation aliases.
This section covers the DNS and panel configuration required to use Hydrodactyl subdomains reliably.
For Hydrodactyl-specific issues, please use Hydrodactyl Discord instead of Pterodactyl or Pelican support channels.
Before You Start
Make sure all of the following are true before you debug a subdomain failure:
- Your server's egg includes a supported subdomain feature such as
subdomain_minecraft,subdomain_factorio,subdomain_rust,subdomain_scpsl, orsubdomain_teamspeak. - You have created at least one active domain in Admin -> Settings -> Domains.
- If you want new supported servers to receive generated subdomains automatically, mark one domain as the default domain.
- Your node and allocations are configured to publish a public address.
Allocation Aliases And Public DNS
Hydrodactyl creates DNS records from the server's primary allocation.
- If your allocations already use public IP addresses, you can publish them directly.
- If your node uses private allocation IPs, NAT, or another internal network layout,
enable Domain by Allocation Alias on the node and set each allocation's
ip_aliasto the public IP you want DNS to publish.
If Domain by Allocation Alias is enabled but the allocation alias is blank, the created record can point at the wrong address. This is one of the most common subdomain setup mistakes.