Part of BlackRoad OS — Sovereign Computing for Everyone
ulackroad deployment docs is part of the BlackRoad OS ecosystem — a sovereign, distributed operating system built on edge computing, local AI, and mesh networking by BlackRoad OS, Inc.
BlackRoad OS is a sovereign computing platform that runs AI locally on your own hardware. No cloud dependencies. No API keys. No surveillance. Built by BlackRoad OS, Inc., a Delaware C-Corp founded in 2025.
- Local AI — Run LLMs on Raspberry Pi, Hailo-8, and commodity hardware
- Mesh Networking — WireGuard VPN, NATS pub/sub, peer-to-peer communication
- Edge Computing — 52 TOPS of AI acceleration across a Pi fleet
- Self-Hosted Everything — Git, DNS, storage, CI/CD, chat — all sovereign
- Zero Cloud Dependencies — Your data stays on your hardware
| Organization | Focus |
|---|---|
| BlackRoad OS | Core platform and applications |
| BlackRoad OS, Inc. | Corporate and enterprise |
| BlackRoad AI | Artificial intelligence and ML |
| BlackRoad Hardware | Edge hardware and IoT |
| BlackRoad Security | Cybersecurity and auditing |
| BlackRoad Quantum | Quantum computing research |
| BlackRoad Agents | Autonomous AI agents |
| BlackRoad Network | Mesh and distributed networking |
| BlackRoad Education | Learning and tutoring platforms |
| BlackRoad Labs | Research and experiments |
| BlackRoad Cloud | Self-hosted cloud infrastructure |
| BlackRoad Forge | Developer tools and utilities |
- Website: blackroad.io
- Documentation: docs.blackroad.io
- Chat: chat.blackroad.io
- Search: search.blackroad.io
Complete operational documentation for deploying sites across the BlackRoad infrastructure.
- DEPLOYMENT-SYSTEM-README.md - Complete guide to the universal deployment script
- blackroad-deploy-system.sh - The deployment script itself
- dns-update-guide.md - Manual DNS update procedures (rarely needed)
- docs-deployment-summary.md - Master infrastructure inventory and docs.blackroad.io deployment
- lucidia-earth-deployment-summary.md - lucidia.earth deployment details
- lucidia-earth-deployment-plan.md - Original build plan for lucidia.earth
Deploy any domain with one command:
# Deploy to Cloudflare Pages (static sites)
~/blackroad-deploy-system.sh pages myapp.blackroad.io ~/projects/myapp
# Deploy to Docker on aria64 (dynamic sites)
~/blackroad-deploy-system.sh docker api.blackroad.io ~/projects/api
# Route existing port through tunnel
~/blackroad-deploy-system.sh tunnel newsite.blackroad.io 3060- aria64 (192.168.4.64) - Raspberry Pi running all Docker containers
- Caddy - Reverse proxy handling all HTTP/HTTPS routing
- Cloudflare Tunnel - Secure routing without port forwarding
- Cloudflare Pages - Static site hosting platform
- Cloudflare Pages - Best for static sites (Next.js, React, Vue)
- Docker on aria64 - Best for APIs and custom backends
- Cloudflare Tunnel - Route existing services to public domains
- ✅ Zero-config DNS (Cloudflare Tunnel auto-creates records)
- ✅ Automatic SSL certificates
- ✅ GitHub integration
- ✅ Container management
- ✅ Port allocation
- blackroad.io (Port 3000) - Main landing page
- lucidia.earth (Port 3040) - The soul site
- docs.blackroad.io (Port 3050) - Documentation
- earth.blackroad.io (Port 3013) - Earth subdomain
- 16+ other sites (Ports 3001-3031) - Various BlackRoad projects
- Caddy (Ports 80/443) - Reverse proxy
- Portainer (Ports 9000/9443) - Container management
- LLM Service (Port 8000) - AI services
~/blackroad-deploy-system.sh status yourdomain.com~/blackroad-deploy-system.sh listcd ~/projects/yoursite
git add . && git commit -m "Updates" && git push
ssh aria64 "cd ~/blackroad/yoursite && git pull && docker build -t yoursite:latest . && docker restart yoursite"ssh aria64 "docker logs -f container-name"For issues, check:
- Script output for detailed error messages
- Container logs:
docker logs container-name - Caddy logs:
docker logs caddy - DNS resolution:
dig +short domain @1.1.1.1 - Status check:
~/blackroad-deploy-system.sh status domain
Last Updated: March 3, 2026 Status: Production Ready ✅
Copyright © 2026 BlackRoad OS, Inc. All Rights Reserved.
CEO: Alexa Amundson | PROPRIETARY AND CONFIDENTIAL
This software is NOT for commercial resale. Testing purposes only.
- 30,000 AI Agents
- 30,000 Human Employees
- CEO: Alexa Amundson
Contact: blackroad.systems@gmail.com
See LICENSE for complete terms.