DNS Management

Shardlyn integrates with Cloudflare to manage DNS records for your instances and applications. Assign custom domains to workloads directly from the dashboard.

Prerequisites

Before using DNS management, you need:

1. A domain managed by Cloudflare
2. A Cloudflare API token with DNS edit permissions
3. The API token added to Shardlyn in Settings > Credentials

Creating a Cloudflare API Token

1. Go to Cloudflare Dashboard > API Tokens
2. Click Create Token
3. Use the Edit zone DNS template (or create a custom token with Zone.DNS permissions)
4. Scope the token to the zones you want to manage
5. Copy the token and add it to Settings > Credentials in Shardlyn

Managing DNS Records

Creating a Record

1. Navigate to Settings > DNS
2. Click Add Record
3. Select the credential and DNS zone
4. Configure the record:
   • Type: A, AAAA, CNAME, SRV, etc.
   • Name: Subdomain (e.g., mc for mc.yourdomain.com)
   • Content: IP address or target
   • TTL: Time to live (optional, defaults to auto)
5. Optionally link the record to a node for automatic IP updates
6. Click Create

Updating a Record

1. Navigate to Settings > DNS
2. Click on the record to edit
3. Modify the fields
4. Click Save

Deleting a Record

1. Navigate to Settings > DNS
2. Click Delete on the record
3. Confirm the deletion

Automatic DNS

Shardlyn can automatically create DNS records when you provision new nodes or deploy instances.

Configuring Auto-DNS

1. Navigate to Settings > DNS
2. Click Auto-DNS Configuration
3. Select the Cloudflare credential and zone
4. Set a subdomain template (e.g., {node-name}.servers creates node-1.servers.yourdomain.com)
5. Enable auto-DNS

When auto-DNS is enabled, Shardlyn automatically:

• Creates an A record when a node is provisioned
• Updates the record if the node's IP changes
• Removes the record when the node is deleted

Linking Records to Nodes

You can link a DNS record to a specific node. When linked:

• The record's content (IP address) stays in sync with the node
• If the node's IP changes, the DNS record updates automatically

To link a record:

1. Create or edit a DNS record
2. Select a node from the Node dropdown
3. Save the record

Common Setups

Game Server or App with Custom Domain

mc.yourdomain.com → A → 203.0.113.10 (node IP)

Players connect to mc.yourdomain.com:25565 instead of a raw IP address.

SRV Record for Minecraft

Minecraft clients can connect without specifying a port using an SRV record:

_minecraft._tcp.yourdomain.com → SRV → 0 5 25565 mc.yourdomain.com

Players connect to just yourdomain.com.

Wildcard for Multiple Servers

*.servers.yourdomain.com → A → 203.0.113.10

All subdomains under servers.yourdomain.com resolve to your node.

Next Steps

• Cloud Provisioning — Provision nodes with automatic DNS record creation
• Connecting Nodes — Register existing servers and link DNS records
• Security — Manage Cloudflare API tokens and credentials