305 lines
6.9 KiB
Markdown
305 lines
6.9 KiB
Markdown
# 🌍 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
|
|
1. Go to **Cloudflare Dashboard**
|
|
2. Navigate to: **Workers & Pages** → **blackroad-metaverse**
|
|
3. Click **Custom domains** tab
|
|
4. Click **Set up a custom domain**
|
|
5. Enter: `www.lucidia.earth`
|
|
6. Click **Continue**
|
|
7. 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:
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
1. Add lucidia.earth to Cloudflare
|
|
2. Set up Page Rules to route www → Pages
|
|
3. Keep other traffic going to 192.168.4.38
|
|
|
|
### Option B: Deploy Locally to Lucidia
|
|
```bash
|
|
# 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
|
|
```nginx
|
|
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:
|
|
|
|
1. **Check Domain Ownership**
|
|
```bash
|
|
whois lucidia.earth | grep -i registrar
|
|
```
|
|
|
|
2. **If domain is in Cloudflare:**
|
|
- Go to Cloudflare Dashboard
|
|
- Add custom domain to Pages project
|
|
- Done in 2 minutes!
|
|
|
|
3. **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
|
|
|
|
4. **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?
|
|
```bash
|
|
# 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!**
|
|
|
|
1. Open: https://dash.cloudflare.com
|
|
2. Find: blackroad-metaverse project
|
|
3. Add: www.lucidia.earth
|
|
4. Wait: 1-5 minutes
|
|
5. **DONE!** 🎊
|
|
|
|
---
|
|
|
|
## 📞 Need Help?
|
|
|
|
If you need credentials or have questions:
|
|
1. Check if domain is already in Cloudflare
|
|
2. Verify you have access to the Cloudflare account
|
|
3. 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*
|