This commit adds comprehensive canonical documentation for all BlackRoad
infrastructure, domains, and services.
Documentation includes:
- BLACKROAD_CANONICAL_TRUTH.md - Master source of truth
- 19 GoDaddy registered domains
- 58 Cloudflare Pages projects
- 15 GitHub organizations
- 40+ repositories
- 7 physical devices (Raspberry Pis + VPS)
- 4 AI platform integrations
- Complete network plane taxonomy
- IP addressing schema
- Secrets management locations
- COMPLETE_DOMAIN_MASTER_LIST.md - All domains & projects
- Complete Cloudflare Pages inventory
- Domain-to-project mapping
- Deployment instructions
- DNS configurations
- LUCIDIA_EARTH_INFRASTRUCTURE.md - Infrastructure guide
- Cloudflare Pages, Workers, Tunnels
- Raspberry Pi deployment
- Docker configurations
- Claude Code integration
- QUICK_DEPLOY.md - Fast deployment reference
- ALL_DOMAINS_REFERENCE.md - Domain routing details
Automation scripts:
- blackroad-deploy-all.sh - Master deployment orchestrator
- blackroad-netdump.sh - Network inventory collector
All 19 domains:
- lucidia.earth (metaverse)
- blackroad.io (corporate)
- blackroadqi.com (quantum intelligence)
- blackroadquantum.{com,info,net,shop,store}
- roadchain.io, roadcoin.io
- And 10 more domains
Infrastructure as scripture. Complete canonical truth.
🤖 Generated with Claude Code (Cece)
Co-Authored-By: Claude <noreply@anthropic.com>
14 KiB
Complete Domain Reference for All BlackRoad & Lucidia Infrastructure
Owner: Alexa Louise Amundson Organization: BlackRoad Inc. Last Updated: 2025-12-22
Domain Summary
Total Domains: 16+ zones Total Cloudflare Pages Projects: 50+ Raspberry Pi Devices: 4 Cloud VPS: 1 (DigitalOcean)
Primary Domains
Lucidia Ecosystem
| Domain | Zone ID | Pages Project | Purpose | Status |
|---|---|---|---|---|
| lucidia.earth | 848cf0b18d51e0170e0d1537aec3505a | lucidia-earth | Metaverse platform | ✅ Active |
Subdomains:
api.lucidia.earth→ Raspberry Pi 192.168.4.38:3000ws.lucidia.earth→ Raspberry Pi 192.168.4.38:8080 (WebSocket)admin.lucidia.earth→ lucidia-admin.pages.devdocs.lucidia.earth→ lucidia-docs.pages.devdev.lucidia.earth→ lucidia-dev.pages.dev
Related Pages Projects:
- lucidia-earth.pages.dev (main metaverse)
- lucidia-platform.pages.dev
- lucidia-core.pages.dev
- lucidia-math.pages.dev
BlackRoad Primary
| Domain | Zone ID | Pages Project | Purpose | Status |
|---|---|---|---|---|
| blackroad.io | TBD | blackroad-io | Corporate site | ✅ Active |
Subdomains:
earth.blackroad.io→ earth-blackroad-io.pages.devdemo.blackroad.io→ blackroad-os-demo.pages.devhome.blackroad.io→ blackroad-os-home.pages.devapi.blackroad.io→ DigitalOcean 159.65.43.12:3000creator-studio.blackroad.io→ blackroad-hello.pages.devcreator.blackroad.io→ blackroad-hello.pages.devdevops.blackroad.io→ blackroad-hello.pages.deveducation.blackroad.io→ blackroad-hello.pages.devfinance.blackroad.io→ blackroad-hello.pages.devideas.blackroad.io→ blackroad-hello.pages.devlegal.blackroad.io→ blackroad-hello.pages.devresearch-lab.blackroad.io→ blackroad-hello.pages.devstudio.blackroad.io→ blackroad-hello.pages.dev
BlackRoad Quantum Suite
| Domain | Pages Project | Purpose |
|---|---|---|
| blackroadquantum.info | blackroad-os-web | Quantum information |
| blackroadquantum.net | blackroad-os-web | Quantum network |
| blackroadquantum.shop | blackroad-os-web | Quantum shop |
| blackroadquantum.store | blackroad-os-web | Quantum store |
| blackroadqi.com | blackroad-os-web | Quantum intelligence |
Other BlackRoad Domains
| Domain | Pages Project | Purpose |
|---|---|---|
| blackroad.me | blackroad-me | Personal site |
| blackroad.systems | blackroad-systems | Systems dashboard |
| roadchain.io | roadchain-io | Blockchain platform |
| roadcoin.io | roadcoin-io | Cryptocurrency |
All Cloudflare Pages Projects
Active Deployments (Most Recent First)
- roadworld → roadworld.pages.dev
- lucidia-earth → lucidia-earth.pages.dev ⭐ MAIN METAVERSE
- earth-blackroad-io → earth-blackroad-io.pages.dev, earth.blackroad.io
- blackroad-io → blackroad-io.pages.dev, blackroad.io
- blackroad-os-web → blackroad-os-web.pages.dev + 6 quantum domains
- blackroad-hello → blackroad-hello.pages.dev + 10 subdomains
- blackroad-os-demo → blackroad-os-demo.pages.dev, demo.blackroad.io
- blackroad-os-home → blackroad-os-home.pages.dev, home.blackroad.io
- blackroad-pitstop → blackroad-pitstop.pages.dev
- blackroad-metaverse → blackroad-metaverse.pages.dev
- blackroad-prism-console → blackroad-prism-console.pages.dev
- blackroad-console → blackroad-console.pages.dev
- applier-blackroad → applier-blackroad.pages.dev
- blackroad-gateway-web → blackroad-gateway-web.pages.dev
- blackroad-assets → blackroad-assets.pages.dev
- blackroad-portals → blackroad-portals.pages.dev
- blackroad-blackroadquantum → blackroad-blackroadquantum.pages.dev
- blackroad-blackroad-io → blackroad-blackroad-io.pages.dev
- blackroad-cece → blackroad-cece.pages.dev
- blackroad-blackroadai → blackroad-blackroadai.pages.dev
- blackroad-blackroad-me → blackroad-blackroad-me.pages.dev
- blackroad-portals-unified → blackroad-portals-unified.pages.dev
- blackroad-unified → blackroad-unified.pages.dev
- blackroad-status → blackroad-status.pages.dev
- blackroad-os-prism → blackroad-os-prism.pages.dev
- blackroad-hello-test → blackroad-hello-test.pages.dev
- lucidia-platform → lucidia-platform.pages.dev
- lucidia-math → lucidia-math.pages.dev
- lucidia-core → lucidia-core.pages.dev
- blackroad-tools → blackroad-tools.pages.dev
- blackroad-agents → blackroad-agents.pages.dev
- blackroad-chat → blackroad-chat.pages.dev
- blackroad-status-new → blackroad-status-new.pages.dev
- blackroad-admin → blackroad-admin.pages.dev
- blackroad-analytics → blackroad-analytics.pages.dev
- blackroad-builder → blackroad-builder.pages.dev
- blackroad-store → blackroad-store.pages.dev
- blackroad-workflows → blackroad-workflows.pages.dev
- blackroad-docs-hub → blackroad-docs-hub.pages.dev
- blackroad-payment-page → blackroad-payment-page.pages.dev
- blackroad-buy-now → blackroad-buy-now.pages.dev
- blackroad-company → blackroad-company.pages.dev
- roadcoin-io → roadcoin-io.pages.dev
- blackroad-systems → blackroad-systems.pages.dev
- blackroad-me → blackroad-me.pages.dev
- roadchain-io → roadchain-io.pages.dev
- blackroad-api → blackroad-api.pages.dev
- roadwork-production → roadwork-production.pages.dev
- remotejobs-platform → remotejobs-platform.pages.dev
- openai-structured-output → openai-structured-output.pages.dev
Cloudflare Workers
Active Workers
-
lucidia-earth-router
- Routes: lucidia.earth/*
- Target: lucidia-earth.pages.dev
- Location: ~/lucidia-earth-router
-
blackroad-landing-worker
- Target: blackroad-io.pages.dev
- Location: ~/blackroad-landing-worker
-
br-8080-cadillac (Port 8080 Cadillac)
- Origin agent
- Created: 7 months ago
Physical Infrastructure
Raspberry Pi Devices
| Device | IP Address | Hostname | Services | Location |
|---|---|---|---|---|
| Lucidia Pi | 192.168.4.38 | lucidia | Backend API, WebSocket, Database | Home Network |
| Lucidia Alt | 192.168.4.99 | lucidia | Backup services | Home Network |
| BlackRoad Pi | 192.168.4.64 | blackroad-pi | Secondary services | Home Network |
| iPhone Koder | 192.168.4.68:8080 | iphone-koder | Mobile development | Home Network |
Cloud VPS
| Provider | IP | Hostname | Services |
|---|---|---|---|
| DigitalOcean | 159.65.43.12 | codex-infinity | BlackRoad API, Services |
GitHub Organizations & Repositories
Organizations
- BlackRoad-OS (primary)
- blackboxprogramming (15 orgs total, 66 repos)
Key Repositories
- lucidia-metaverse
- lucidia-earth-router
- lucidia-backend
- blackroad-os-web
- blackroad-os-core
- blackroad-os-prism
- blackroad-pi-ops
- blackroad-agents
- And 58+ more...
Connection Methods
Cloudflare Pages Deploy
Method 1: Direct CLI
wrangler pages deploy dist --project-name=<project-name>
Method 2: Git Integration
git push origin main
# Auto-deploys via Cloudflare Pages Git integration
Method 3: GitHub Actions
- uses: cloudflare/wrangler-action@v3
with:
apiToken: ${{ secrets.CF_API_TOKEN }}
command: pages deploy dist --project-name=<project>
Cloudflare Workers Deploy
cd ~/worker-directory
wrangler deploy
Raspberry Pi Deploy (via SSH)
# Method 1: Direct SSH
ssh pi@192.168.4.38 'cd ~/project && git pull && docker-compose up -d --build'
# Method 2: Cloudflare Tunnel
cloudflared tunnel --url http://localhost:3000
Raspberry Pi Deploy (via Cloudflare Tunnel - Shellfish)
Setup Tunnel:
# On Pi
cloudflared tunnel login
cloudflared tunnel create lucidia-backend
cloudflared tunnel route dns lucidia-backend api.lucidia.earth
# Configure
nano ~/.cloudflared/config.yml
Config:
tunnel: <TUNNEL_ID>
credentials-file: /home/pi/.cloudflared/<TUNNEL_ID>.json
ingress:
- hostname: api.lucidia.earth
service: http://localhost:3000
- hostname: ws.lucidia.earth
service: http://localhost:8080
- service: http_status:404
Run:
cloudflared tunnel run lucidia-backend
Docker Deployments
On Raspberry Pi:
ssh pi@192.168.4.38
# Navigate to project
cd ~/lucidia-backend
# Deploy with Docker Compose
docker-compose up -d --build
# View logs
docker-compose logs -f
# Restart specific service
docker-compose restart api
Docker Compose Structure:
services:
api:
image: node:18-alpine
ports: ["3000:3000"]
websocket:
image: node:18-alpine
ports: ["8080:8080"]
postgres:
image: postgres:15-alpine
ports: ["5432:5432"]
redis:
image: redis:7-alpine
ports: ["6379:6379"]
Claude Code Integration
Deploy via Claude:
# Claude can execute deployment scripts
~/lucidia-deploy.sh
# Or individual commands
cd ~/lucidia-metaverse && npm run build && wrangler pages deploy dist --project-name=lucidia-earth
Claude Automation:
# Create deployment script
cat > ~/deploy-all-domains.sh << 'EOF'
#!/bin/bash
# Deploy all infrastructure
# Lucidia
cd ~/lucidia-metaverse && npm run build && wrangler pages deploy dist --project-name=lucidia-earth
cd ~/lucidia-earth-router && wrangler deploy
# BlackRoad
cd ~/blackroad-io && npm run build && wrangler pages deploy dist --project-name=blackroad-io
# Backend
ssh pi@192.168.4.38 'cd ~/lucidia-backend && docker-compose up -d --build'
echo "✅ All deployments complete"
EOF
chmod +x ~/deploy-all-domains.sh
DNS Configuration Reference
Standard Cloudflare Pages Setup
Type: CNAME
Name: @ (or subdomain)
Content: <project-name>.pages.dev
Proxy Status: Proxied (orange cloud)
TTL: Auto
Cloudflare Worker Setup
Type: CNAME
Name: @
Content: <worker-name>.workers.dev
Proxy Status: Proxied
TTL: Auto
# Worker Routes configured in wrangler.toml:
[[routes]]
pattern = "domain.com/*"
zone_name = "domain.com"
Raspberry Pi via Tunnel
Type: CNAME
Name: api (or subdomain)
Content: <tunnel-id>.cfargotunnel.com
Proxy Status: Proxied
TTL: Auto
Raspberry Pi via Direct IP (Not Recommended)
Type: A
Name: api
Content: 192.168.4.38
Proxy Status: DNS Only (grey cloud)
TTL: Auto
Domain Addition Workflow
Adding New Domain to Cloudflare
Step 1: Add Zone
curl -X POST "https://api.cloudflare.com/client/v4/zones" \
-H "Authorization: Bearer yP5h0HvsXX0BpHLs01tLmgtTbQurIKPL4YnQfIwy" \
-H "Content-Type: application/json" \
--data '{
"name": "newdomain.com",
"account": {
"id": "463024cf9efed5e7b40c5fbe7938e256"
}
}'
Step 2: Update Nameservers
Update at domain registrar:
NS1: alexa.ns.cloudflare.com
NS2: tommy.ns.cloudflare.com
Step 3: Create Pages Project
cd ~/new-project
npm run build
wrangler pages deploy dist --project-name=newdomain-com
Step 4: Add Custom Domain
# Via Cloudflare Dashboard:
# Pages → Project → Custom Domains → Add Domain → newdomain.com
Step 5: Create Worker (if routing needed)
mkdir ~/newdomain-router
cd ~/newdomain-router
# Create wrangler.toml
cat > wrangler.toml << 'EOF'
name = "newdomain-router"
main = "src/index.ts"
compatibility_date = "2025-01-01"
[vars]
PAGES_URL = "https://newdomain-com.pages.dev"
[[routes]]
pattern = "newdomain.com/*"
zone_name = "newdomain.com"
EOF
# Create worker code
mkdir -p src
cat > src/index.ts << 'EOF'
interface Env {
PAGES_URL: string;
}
export default {
async fetch(request: Request, env: Env): Promise<Response> {
const url = new URL(request.url);
const pagesUrl = new URL(url.pathname + url.search, env.PAGES_URL);
const response = await fetch(pagesUrl.toString(), {
method: request.method,
headers: request.headers,
body: request.body,
});
return new Response(response.body, response);
},
};
EOF
# Deploy
wrangler deploy
Monitoring & Health Checks
Cloudflare Analytics
- Dashboard → Analytics → Traffic
- Pages → Project → Analytics
- Workers → Analytics
Custom Health Check Script
#!/bin/bash
# health-check-all.sh
echo "🔍 Checking all domains..."
DOMAINS=(
"lucidia.earth"
"blackroad.io"
"blackroadquantum.info"
"blackroadqi.com"
"roadchain.io"
)
for domain in "${DOMAINS[@]}"; do
echo -n "Checking https://$domain ... "
STATUS=$(curl -s -o /dev/null -w "%{http_code}" "https://$domain")
if [ "$STATUS" -eq 200 ]; then
echo "✅ OK ($STATUS)"
else
echo "❌ FAILED ($STATUS)"
fi
done
echo ""
echo "🥧 Checking Raspberry Pis..."
ping -c 1 192.168.4.38 > /dev/null && echo "✅ Lucidia Pi (192.168.4.38)" || echo "❌ Lucidia Pi"
ping -c 1 192.168.4.64 > /dev/null && echo "✅ BlackRoad Pi (192.168.4.64)" || echo "❌ BlackRoad Pi"
ping -c 1 192.168.4.68 > /dev/null && echo "✅ iPhone Koder (192.168.4.68)" || echo "❌ iPhone Koder"
echo ""
echo "🐳 Checking Docker containers..."
ssh pi@192.168.4.38 'docker ps --format "table {{.Names}}\t{{.Status}}"'
Railway Projects
12+ projects deployed
- Location: https://railway.app
- Access via GitHub integration
- Auto-deploy from main branch
Summary Statistics
- Cloudflare Pages: 50+ projects
- Cloudflare Workers: 3+ active
- Domains: 16+ zones
- Subdomains: 30+
- Raspberry Pis: 4 devices
- Cloud VPS: 1 (DigitalOcean)
- GitHub Orgs: 15
- GitHub Repos: 66+
- Railway Projects: 12+
Quick Access Commands
# Deploy everything
~/deploy-all-domains.sh
# Check all health
~/health-check-all.sh
# SSH to Pis
ssh pi@192.168.4.38 # Lucidia
ssh pi@192.168.4.64 # BlackRoad
ssh pi@192.168.4.68 # iPhone
# SSH to Cloud
ssh root@159.65.43.12 # DigitalOcean
# Wrangler commands
wrangler pages project list
wrangler deployments list
wrangler tail
# Docker on Pi
ssh pi@192.168.4.38 'docker ps'
ssh pi@192.168.4.38 'docker-compose logs -f'
Maintained By: Claude Code + Alexa Louise Amundson Support: blackroad.systems@gmail.com Primary: amundsonalexa@gmail.com