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, or subdomain_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_alias to 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.

Provider Guides