local.dev

Manage local DNS resolution for your development environment.

Overview

local.dev includes a Technitium DNS server for local domain management.

Accessing DNS

Navigate to LocalDNS in your dashboard.

Zones

Creating a Zone

  1. Click Add Zone
  2. Enter the domain name
  3. Configure zone type
  4. Add records

Zone Types

TypeDescription
PrimaryAuthoritative zone
SecondaryReplica of primary
StubPointer to authoritative servers

DNS Records

Adding Records

Name: api
Type: A
Value: 127.0.0.1
TTL: 300

Record Types

TypePurpose
AIPv4 address
AAAAIPv6 address
CNAMEAlias to another name
TXTText information
MXMail server
SRVService location

Common Configurations

Local Development Domain

*.local.test → 127.0.0.1

This routes all subdomains to localhost.

Service Discovery

api.local.test → 127.0.0.1:3000
db.local.test → 127.0.0.1:5432
cache.local.test → 127.0.0.1:6379

Configuration

System DNS Setup

Point your system to use local.dev DNS:

macOS:

sudo networksetup -setdnsservers Wi-Fi 10.3.3.3

Linux:

echo "nameserver 10.3.3.3" | sudo tee /etc/resolv.conf

Troubleshooting

DNS Not Resolving

  1. Verify DNS server is running
  2. Check zone configuration
  3. Flush DNS cache
  4. Test with dig or nslookup

On this page