blackroad-domains/QUICK_DEPLOY.md

Lucidia.Earth Quick Deployment Guide

Last Updated: 2025-12-22

---

One-Command Deployments

Deploy Everything

~/lucidia-deploy.sh

Deploy Frontend Only

cd ~/lucidia-metaverse && npm run build && wrangler pages deploy dist --project-name=lucidia-earth

Deploy Worker Only

cd ~/lucidia-earth-router && wrangler deploy

Deploy Backend (Raspberry Pi) Only

ssh pi@192.168.4.38 'cd ~/lucidia-backend && git pull && docker-compose up -d --build'

---

Emergency Procedures

Complete Site Down

# 1. Check Cloudflare status
curl -I https://lucidia.earth

# 2. Check worker
wrangler tail

# 3. Check Pages
curl -I https://lucidia-earth.pages.dev

# 4. If worker issue, redeploy
cd ~/lucidia-earth-router && wrangler deploy

# 5. If Pages issue, redeploy
cd ~/lucidia-metaverse && wrangler pages deploy dist --project-name=lucidia-earth

# 6. Clear Cloudflare cache
curl -X POST "https://api.cloudflare.com/client/v4/zones/848cf0b18d51e0170e0d1537aec3505a/purge_cache" \
  -H "Authorization: Bearer yP5h0HvsXX0BpHLs01tLmgtTbQurIKPL4YnQfIwy" \
  -H "Content-Type: application/json" \
  --data '{"purge_everything":true}'

Backend API Down

# 1. Check Pi connectivity
ping 192.168.4.38

# 2. SSH and check Docker
ssh pi@192.168.4.38 'docker ps'

# 3. Restart containers
ssh pi@192.168.4.38 'cd ~/lucidia-backend && docker-compose restart'

# 4. Check logs
ssh pi@192.168.4.38 'cd ~/lucidia-backend && docker-compose logs --tail=100'

# 5. Full rebuild if needed
ssh pi@192.168.4.38 'cd ~/lucidia-backend && docker-compose up -d --build --force-recreate'

Rollback to Previous Version

# Frontend rollback
wrangler pages deployment list --project-name=lucidia-earth
wrangler pages deployment rollback <DEPLOYMENT_ID> --project-name=lucidia-earth

# Worker rollback
wrangler deployments list
wrangler rollback [VERSION_ID]

# Backend rollback
ssh pi@192.168.4.38 << 'EOF'
  cd ~/lucidia-backend
  git log --oneline -10
  git reset --hard <COMMIT_SHA>
  docker-compose up -d --build
EOF

---

Health Checks

Quick Status Check

# All services
curl -I https://lucidia.earth && \
curl -I https://lucidia-earth.pages.dev && \
ssh pi@192.168.4.38 'docker ps | grep lucidia'

Individual Service Checks

# Frontend
curl https://lucidia.earth | grep "Lucidia Metaverse"

# Worker
curl -I https://lucidia.earth | grep "X-Served-By"

# Backend API
curl https://api.lucidia.earth/health

# WebSocket
wscat -c wss://ws.lucidia.earth

---

Common Tasks

Update Frontend Code

cd ~/lucidia-metaverse
# Edit files
npm run build
wrangler pages deploy dist --project-name=lucidia-earth

Update Backend Code

ssh pi@192.168.4.38 << 'EOF'
  cd ~/lucidia-backend
  git pull
  docker-compose up -d --build
EOF

Add New Environment Variable

# For Worker
cd ~/lucidia-earth-router
wrangler secret put NEW_SECRET

# For Pages
# Add via Cloudflare Dashboard: Pages → Settings → Environment Variables

# For Pi/Docker
ssh pi@192.168.4.38
cd ~/lucidia-backend
nano .env
# Add: NEW_VAR=value
docker-compose up -d --force-recreate

View Logs

# Worker logs
wrangler tail

# Pages deployment logs
wrangler pages deployment tail

# Pi/Docker logs
ssh pi@192.168.4.38 'cd ~/lucidia-backend && docker-compose logs -f'

# Specific container
ssh pi@192.168.4.38 'docker logs -f lucidia-api'

---

Credentials Quick Access

# Cloudflare Account ID
463024cf9efed5e7b40c5fbe7938e256

# Cloudflare Zone ID (lucidia.earth)
848cf0b18d51e0170e0d1537aec3505a

# Cloudflare API Token
yP5h0HvsXX0BpHLs01tLmgtTbQurIKPL4YnQfIwy

# Raspberry Pi IPs
# Lucidia: 192.168.4.38
# BlackRoad: 192.168.4.64
# iPhone: 192.168.4.68:8080
# DigitalOcean: 159.65.43.12

---

URLs

# Production
https://lucidia.earth

# Pages Direct
https://lucidia-earth.pages.dev

# Backend API
https://api.lucidia.earth

# WebSocket
wss://ws.lucidia.earth

# Admin
https://admin.lucidia.earth

# Docs
https://docs.lucidia.earth

---

Support

• Email: blackroad.systems@gmail.com
• Primary: amundsonalexa@gmail.com
• Full Docs: ~/lucidia-earth-router/LUCIDIA_EARTH_INFRASTRUCTURE.md