Sankofa/docs/proxmox/CLOUDFLARE_DOMAIN_SETUP.md

Cloudflare Domain Setup Guide

Last Updated: 2024-12-19

Current Status

The domain sankofa.nexus is not currently in your Cloudflare account. You need to add it before DNS records can be created.

Option 1: Add Domain to Cloudflare (Recommended)

Steps

1. Log in to Cloudflare Dashboard

   • Go to: https://dash.cloudflare.com
   • Log in with: pandoramannli@gmail.com

2. Add Domain

   • Click "Add a Site" or "Add Site"
   • Enter: sankofa.nexus
   • Click "Add site"

3. Choose Plan

   • Select a plan (Free plan is sufficient for DNS)

4. Update Nameservers

   • Cloudflare will provide nameservers (e.g., ns1.cloudflare.com, ns2.cloudflare.com)
   • Update your domain registrar to use these nameservers
   • Wait for DNS propagation (can take up to 24 hours, usually much faster)

5. Verify Domain is Active

   • Once nameservers are updated, Cloudflare will show the domain as "Active"

6. Get Zone ID

   ./scripts/get-cloudflare-info.sh
   

   This will automatically retrieve and add the Zone ID to .env

7. Create DNS Records

   ./scripts/setup-dns-records.sh
   

Option 2: Use Existing Domain

If you have another domain already in Cloudflare:

1. Check Available Domains

   source .env
   curl -s -X GET "https://api.cloudflare.com/client/v4/zones" \
     -H "X-Auth-Email: ${CLOUDFLARE_EMAIL}" \
     -H "X-Auth-Key: ${CLOUDFLARE_API_KEY}" | \
     jq -r '.result[] | "\(.name) - Zone ID: \(.id)"'
   

2. Update Configuration

   • Update DOMAIN in .env to use existing domain
   • Update all configuration files that reference sankofa.nexus

Option 3: Use Subdomain

If you want to use a subdomain of an existing domain:

1. Identify Parent Domain

   • Check available zones (see Option 2)

2. Create Subdomain Records

   • Use the parent domain's Zone ID
   • Create records like proxmox1.parent-domain.com

3. Update Configuration

   • Update DOMAIN in .env
   • Update FQDNs in configuration files

Verification

After adding the domain, verify it's accessible:

# Get Zone ID
./scripts/get-cloudflare-info.sh

# Check Zone ID in .env
grep ZONE_ID .env

# Create DNS records
./scripts/setup-dns-records.sh

DNS Records to be Created

Once the domain is added, the script will create:

For ml110-01 (192.168.11.10):

• ml110-01.sankofa.nexus → A record → 192.168.11.10
• ml110-01-api.sankofa.nexus → CNAME → ml110-01.sankofa.nexus
• ml110-01-metrics.sankofa.nexus → CNAME → ml110-01.sankofa.nexus

For r630-01 (192.168.11.11):

• r630-01.sankofa.nexus → A record → 192.168.11.11
• r630-01-api.sankofa.nexus → CNAME → r630-01.sankofa.nexus
• r630-01-metrics.sankofa.nexus → CNAME → r630-01.sankofa.nexus

Troubleshooting

Domain Not Found

• Issue: Zone ID cannot be retrieved
• Solution: Add domain to Cloudflare account first

Nameservers Not Updated

• Issue: Domain shows as "Pending" in Cloudflare
• Solution: Update nameservers at your domain registrar

DNS Propagation Delay

• Issue: DNS records not resolving
• Solution: Wait for DNS propagation (usually 5-15 minutes, can take up to 24 hours)

API Authentication Errors

• Issue: 401 or 403 errors
• Solution: Verify credentials in .env file are correct

Next Steps

1. Add Domain to Cloudflare (if not already added)
2. Update Nameservers at domain registrar
3. Wait for Activation (domain status becomes "Active")
4. Run Scripts:

   ./scripts/get-cloudflare-info.sh
   ./scripts/setup-dns-records.sh
   

5. Verify DNS Resolution:

   dig ml110-01.sankofa.nexus
   dig r630-01.sankofa.nexus
   

Related Documentation

• Deployment Readiness
• Environment Variables
• DNS Configuration