DNS Integration

connect dns install

🌐 Installing Private Connect DNS...

  Setting up macOS resolver...

  Created: /etc/resolver/connect
  [ok] DNS server started (PID: 12345)

[ok] DNS installed successfully!

  You can now access services via:
    curl http://my-service.connect
    psql -h prod-db.connect

  Commands:
    Status:    connect dns status
    Test:      connect dns test prod-db
    Uninstall: connect dns uninstall

# Database connection
psql -h staging-db.connect -U postgres

# HTTP requests
curl http://api.connect/health

# Application config
DATABASE_URL=postgresql://staging-db.connect/mydb
REDIS_URL=redis://redis.connect:6379

# Install dnsmasq
sudo apt install dnsmasq

# Configure
echo "address=/.connect/127.0.0.1" | sudo tee /etc/dnsmasq.d/pconnect.conf

# Restart
sudo systemctl restart dnsmasq

# Add entries manually
sudo tee -a /etc/hosts << EOF
127.0.0.1 staging-db.connect
127.0.0.1 redis.connect
127.0.0.1 api.connect
EOF

# Start DNS server
connect dns start

# Stop DNS server
connect dns stop

# Check status
connect dns status

# View logs
tail -f ~/.connect/dns.log

const child = spawn(process.execPath, [
  process.argv[1],
  'dns',
  'serve',
  '--port', dnsPort.toString(),
  '--domain', domain,
  '--hub', hubUrl,
], {
  detached: true,
  stdio: ['ignore', logStream, logStream],
  env: { ...process.env, CONNECT_DNS_SERVER: '1' },
});

child.unref();
fs.writeFileSync(pidPath, child.pid?.toString() || '');

# Install with custom domain
connect dns install --domain local

# Now use .local domains
curl http://api.local
psql -h db.local

# Development
connect dns install --domain dev

# Staging
connect dns install --domain staging

# Production
connect dns install --domain prod

curl http://api.dev
curl http://api.staging  
curl http://api.prod

connect dns test staging-db

🔍 Testing DNS resolution for staging-db.connect...

  [ok] Resolved: staging-db.connect -> 127.0.0.1

# PostgreSQL
psql -h staging-db.connect -U postgres -c "SELECT version();"

# Redis
redis-cli -h redis.connect PING

# HTTP
curl -v http://api.connect/health

# MySQL
mysql -h mysql.connect -u root -p

# 1. Install DNS
connect dns install

# 2. Start proxy
connect proxy start

# 3. Reach services
connect reach staging-db 5432
connect reach redis 6379

# 4. Access via .connect domains through proxy
psql -h staging-db.connect -p 9999
redis-cli -h redis.connect -p 9999

connect proxy start --https

curl https://api.connect:9999/health
curl https://frontend.connect:9999/

let serviceCache: Map<string, number> = new Map();
let lastFetch = 0;
const CACHE_TTL = 5000; // 5 seconds

async function refreshServiceCache() {
  const now = Date.now();
  if (now - lastFetch < CACHE_TTL) return;
  
  const response = await fetch(`${hubUrl}/v1/services`, {
    headers: { 'x-api-key': apiKey },
  });
  
  if (response.ok) {
    const services = await response.json();
    serviceCache.clear();
    for (const service of services) {
      if (service.tunnelPort) {
        serviceCache.set(service.name.toLowerCase(), service.tunnelPort);
      }
    }
    lastFetch = now;
  }
}

connect dns uninstall

🌐 Uninstalling Private Connect DNS...

  [ok] DNS server stopped
  Removed: /etc/resolver/connect

[ok] DNS uninstalled

# Check if service is exposed/reached
connect whoami

# Check active routes
cat ~/.connect/active-routes.json

# Verify service in hub
curl -H "x-api-key: $API_KEY" https://hub.privateconnect.io/v1/services

# macOS - creating /etc/resolver requires sudo
[x] Failed to create resolver directory.
  Run: sudo mkdir -p /etc/resolver

sudo connect dns install