Files

Your Name bb3820131c 🌍 Setup www.lucidia.earth deployment

Complete documentation and scripts for custom domain

2026-01-30 15:59:44 -06:00

6.9 KiB

Raw Blame History

🌍 Deploy to www.lucidia.earth - Complete Guide

🎯 Mission: Get BlackRoad Metaverse on www.lucidia.earth!

Date: 2026-01-30
Target Domain: www.lucidia.earth
Source: blackroad-metaverse.pages.dev
Status: Configuration Guide Ready ✅

📋 Prerequisites Check

✅ Cloudflare Pages Project: blackroad-metaverse
✅ Latest Deployment: https://f62efd69.blackroad-metaverse.pages.dev
✅ Domain Name: lucidia.earth (needs verification)
⏳ DNS Configuration: Pending

🚀 Step-by-Step Setup Guide

Option 1: Via Cloudflare Dashboard (Recommended)

Step 1: Add Custom Domain

Go to Cloudflare Dashboard
Navigate to: Workers & Pages → blackroad-metaverse
Click Custom domains tab
Click Set up a custom domain
Enter: www.lucidia.earth
Click Continue
Cloudflare will provide DNS instructions

Step 2: Configure DNS

Cloudflare will automatically add a CNAME record:

Type: CNAME
Name: www
Target: blackroad-metaverse.pages.dev
Proxy: ON (Orange Cloud)

Step 3: Verify

Wait 1-5 minutes for DNS propagation
Visit: https://www.lucidia.earth
You should see the metaverse! 🎉

Option 2: Via Cloudflare API (Automated)

If you have the Cloudflare API token, we can automate this:

# Set your Cloudflare credentials
export CLOUDFLARE_ACCOUNT_ID="your_account_id"
export CLOUDFLARE_API_TOKEN="your_api_token"
export CLOUDFLARE_ZONE_ID="lucidia_earth_zone_id"

# Add custom domain via API
curl -X POST "https://api.cloudflare.com/client/v4/accounts/${CLOUDFLARE_ACCOUNT_ID}/pages/projects/blackroad-metaverse/domains" \
  -H "Authorization: Bearer ${CLOUDFLARE_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"name":"www.lucidia.earth"}'

# Add DNS CNAME record
curl -X POST "https://api.cloudflare.com/client/v4/zones/${CLOUDFLARE_ZONE_ID}/dns_records" \
  -H "Authorization: Bearer ${CLOUDFLARE_API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "type":"CNAME",
    "name":"www",
    "content":"blackroad-metaverse.pages.dev",
    "proxied":true
  }'

🔍 Domain Verification Steps

Check if lucidia.earth is in Cloudflare

# Check Cloudflare zones
wrangler whoami

# Or via API
curl -X GET "https://api.cloudflare.com/client/v4/zones" \
  -H "Authorization: Bearer ${CLOUDFLARE_API_TOKEN}" | jq '.result[] | select(.name=="lucidia.earth")'

🌐 DNS Configuration Details

Required DNS Records

# CNAME for www subdomain
www.lucidia.earth → blackroad-metaverse.pages.dev (Proxied)

# Optional: Redirect apex domain
lucidia.earth → www.lucidia.earth (301 redirect)

Full DNS Setup (If Setting Up New Domain)

# Primary Records
Type    Name    Content                             Proxy   TTL
CNAME   www     blackroad-metaverse.pages.dev       ON      Auto
CNAME   @       blackroad-metaverse.pages.dev       ON      Auto

# Optional Subdomains
CNAME   universe   blackroad-metaverse.pages.dev    ON      Auto
CNAME   metaverse  blackroad-metaverse.pages.dev    ON      Auto

📊 Quick DNS Check Commands

# Check if domain resolves
dig www.lucidia.earth

# Check CNAME record
dig www.lucidia.earth CNAME

# Check with trace
dig +trace www.lucidia.earth

# Test HTTPS
curl -I https://www.lucidia.earth

🎯 Alternative: Deploy to Existing Lucidia Server

If lucidia.earth is pointing to your local Lucidia server (192.168.4.38):

Option A: Proxy Through Cloudflare

Add lucidia.earth to Cloudflare
Set up Page Rules to route www → Pages
Keep other traffic going to 192.168.4.38

Option B: Deploy Locally to Lucidia

# Copy files to Lucidia server
scp -r /Users/alexa/blackroad-metaverse/* pi@192.168.4.38:/var/www/lucidia.earth/

# Set up nginx on Lucidia
ssh pi@192.168.4.38
sudo nano /etc/nginx/sites-available/lucidia.earth

# Add nginx config (see below)

Nginx Configuration

server {
    listen 80;
    listen [::]:80;
    server_name www.lucidia.earth lucidia.earth;
    
    root /var/www/lucidia.earth;
    index index.html universe.html;
    
    location / {
        try_files $uri $uri/ /index.html;
    }
    
    # Gzip compression
    gzip on;
    gzip_types text/html text/css application/javascript;
}

🔥 Fastest Path to Live

Immediate Action Plan:

Check Domain Ownership

whois lucidia.earth | grep -i registrar

If domain is in Cloudflare:
- Go to Cloudflare Dashboard
- Add custom domain to Pages project
- Done in 2 minutes!
If domain is NOT in Cloudflare:
- Add domain to Cloudflare (free plan)
- Update nameservers at registrar
- Wait 24 hours for propagation
- Then add custom domain to Pages
If you want it NOW:
- Use Cloudflare's automatic subdomain
- Already live at: blackroad-metaverse.pages.dev
- Add custom domain later

🎉 What Happens After Setup

Immediate Benefits:

✅ Clean URL: www.lucidia.earth
✅ Automatic HTTPS (Cloudflare SSL)
✅ Global CDN (fast everywhere)
✅ DDoS protection
✅ Caching & optimization

Users Will Visit:

https://www.lucidia.earth → Full metaverse experience
Music plays automatically 🎵
Performance optimized ⚡
Beautiful cohesive design 🎨

🐛 Troubleshooting

Domain Not Resolving?

# Clear DNS cache (Mac)
sudo dscacheutil -flushcache
sudo killall -HUP mDNSResponder

# Check DNS propagation
https://dnschecker.org

SSL Certificate Issues?

Cloudflare auto-generates certificates
Wait 5 minutes after domain add
Use "Full (strict)" SSL mode

404 Errors?

Verify domain is added in Pages Dashboard
Check DNS CNAME target
Ensure deployment is successful

📝 Action Items

Choose your path:

Path 1: Cloudflare Dashboard (5 minutes)

Log into Cloudflare Dashboard
Go to Workers & Pages → blackroad-metaverse
Add custom domain: www.lucidia.earth
Wait for DNS propagation
Visit www.lucidia.earth 🎉

Path 2: API Automation (Need credentials)

Get Cloudflare API token
Get Account ID
Get Zone ID for lucidia.earth
Run API commands
Verify deployment

Path 3: Local Lucidia Server

SSH to Lucidia (192.168.4.38)
Copy metaverse files
Configure nginx
Set up port forwarding
Test locally then expose

🌟 Recommended: Path 1 (Dashboard)

Fastest and most reliable!

Open: https://dash.cloudflare.com
Find: blackroad-metaverse project
Add: www.lucidia.earth
Wait: 1-5 minutes
DONE! 🎊

📞 Need Help?

If you need credentials or have questions:

Check if domain is already in Cloudflare
Verify you have access to the Cloudflare account
Get API token if needed for automation

Ready to make www.lucidia.earth LIVE! 🚀🌍✨

Generated: 2026-01-30
Target: www.lucidia.earth
Status: Configuration Ready

6.9 KiB Raw Blame History