DNS

DNS provides automatic hostname resolution for nodes in your mesh network. Instead of remembering overlay IP addresses, you can reach nodes by name.

Overview

With DNS enabled, you can reach nodes by name:

ping server-01.abc123.baseguard.link
ssh user@database.abc123.baseguard.link
curl http://api.abc123.baseguard.link:8080

Or just by node name (without the domain):

ping server-01
ssh user@database
curl http://api:8080

Instead of remembering IP addresses:

ping 100.64.0.5
ssh user@100.64.0.10
curl http://100.64.0.15:8080

Enabling DNS

1. Go to Settings > DNS
2. Toggle Enable DNS on
3. Your organization domain is automatically assigned (e.g., abc123.baseguard.link)
4. Nodes are accessible via <node-name>.<domain> or just <node-name>

How It Works

1. Each node gets a DNS name: <node-name>.<domain>
2. DNS queries for your domain route to Baseguard's local resolver
3. Resolver looks up node name → overlay IP
4. Normal DNS continues to work for external domains

DNS Names

Format

<node-name>.<domain>

Examples:

• laptop.abc123.baseguard.link
• prod-db-01.abc123.baseguard.link
• web-server.company.internal

Node Names

DNS uses the node name configured in the console. To change:

1. Go to Nodes
2. Click on a node
3. Edit the Name field
4. Save

Valid Names

Node names must be valid DNS labels:

• Lowercase letters, numbers, hyphens
• Max 63 characters
• Cannot start/end with hyphen

Troubleshooting

See Troubleshooting — DNS Issues for solutions to DNS resolution and external DNS problems.

See Also

• Networking — How connections work
• Nodes — Node management
• Organizations — Organization settings
• CLI Status — Check connection status