Repository navigation
π Decentralized.Host v1.0.0 - Production Ready
Sovereign self-hosted infrastructure where hosts stay in control. Zero vendor lock-in. Zero external dependencies.
β What's Complete
Core Milestones (M1βM8)
- M1: Sovereignty β Ed25519 identities, signed work assignments, local admission control
- M2: Storage β BLAKE3 CAS, FastCDC chunking, Merkle anti-entropy repair
- M3: Mesh β Userspace WireGuard, gossip topology, signed key bindings
- M4: TLS & Edge β L7 proxy, ACME (HTTP-01, DNS-01, wildcards)
- M5: HA Control Plane β Raft consensus, ~1.2s failover, zero failed requests
- M6: Chaos Testing β 17 scenarios verified (leader crash, partition, disk full, OOM, clock skew, etc.)
- M7: Federation β Root-signed agreements, delegated placements
- M8: Conformance β 136 test vectors, Python reference implementation
P1 Qualification (10/10 PASS)
β Gates 11-20 (Robustness) β Concurrent admission, capacity enforcement, policy atomicity, clock skew tolerance, artifact quarantine, cascade containment, partition recovery
β Gates 21-32 (Chaos) β Leader crash, control-plane outage, network partition, disk full, OOM, packet chaos, clock skew, storage corruption, cascading failures
Certification: P1-LOCAL-VM-A01 10/10 COMPLETE
Additional Features
- Mail Server Integration β Node.js/Express REST API + SMTP server with PostgreSQL backend
- Docker Image β 151 MB production-ready container
- Complete Documentation β 2500+ lines covering protocol, architecture, runbooks
- GitHub Community Tools β Issue templates, PR template, GitHub Actions CI
π― Key Metrics
- ~1.2 second failover under sustained load (zero workload interruption)
- ~500ms mesh gossip propagation latency
- ~100ms audit verification (local, cryptographic)
- 10,000+ ops/sec sustained throughput
- 17 chaos scenarios verified
π Quick Start (5 minutes)
git clone https://github.com/CodesbyFebin/Decentralized-
cd Decentralized-
make build
./bin/dh dev up --dir ./devcluster
# In another terminal:
export DH_HOME=./devcluster/operator
./bin/dh get apps
./bin/dh mesh peers
./bin/dh chaos run --scenario leader-crashπ Documentation
- README.md β Architecture, features, getting started
- WHY_DECENTRALIZED.md β Value prop vs Kubernetes/Nomad/Cloud
- docs/protocol/dh-v1.md β Complete specification (136 test vectors)
- CONTRIBUTING.md β Developer workflow & testing
- GROWTH_STRATEGY.md β Community engagement plan
- PROJECT_STATUS.md β Complete technical status
π What Makes This Different
β
Sovereignty β Each host has local policy (no centralized override)
β
Signed Intent β All work is Ed25519-signed (no silent mutation)
β
Peer-to-Peer Storage β No central database (BLAKE3 + Merkle healing)
β
Honest State β DESIRED β ADMITTED β EXECUTING β OBSERVED β VERIFIED
β
Zero Vendor Lock-in β Works completely offline, no external APIs
β
Cryptographic Audit β Hash-chained ledger, tamper-proof
π Compared to Alternatives
vs Kubernetes: Simpler, sovereign, signed audit trail, built-in P2P storage
vs Nomad: Signed intent, no external DB, 17 chaos scenarios, 136 conformance vectors
vs Cloud (AWS/GCP/Azure): No vendor lock-in, works offline, predictable costs, full data control
π Qualification Details
| Category | Status | Details |
|---|---|---|
| Robustness | β 10/10 | Concurrent admission, capacity, policy, clock skew, partition recovery |
| Chaos Testing | β 17/17 | Leader crash, partition, disk full, OOM, clock skew, corruption, cascade |
| Conformance | β 136/136 | dh/v1 protocol vectors (Go + Python) |
| Integration | β 100+ | Multi-process testing, WireGuard mesh, Raft consensus |
π οΈ Build & Test
make build # Compile all binaries
make test # Unit tests
make integration # M1βM7 integration tests (~5 min)
make conformance # 136-vector compliance
make chaos # All 17 chaos scenarios (~90 min)π Security & Compliance
β
Ed25519 cryptographic signatures on all work
β
Hash-chained audit trail (tamper-proof)
β
Mutual TLS on control plane APIs
β
Per-host policy enforcement (no global override)
β
Offline audit verification (no external dependency)
β
Full vulnerability disclosure policy (see SECURITY.md)
π Next Steps
- Get Started:
make build && ./bin/dh dev up --dir ./devcluster - Read Docs: Start with README.md or WHY_DECENTRALIZED.md
- Join Community: GitHub Discussions, Issues, Contribute via CONTRIBUTING.md
- Provide Feedback: File issues, share use cases, suggest improvements
π License
GNU Affero General Public License v3. See LICENSE for details.
Built for self-hosted infrastructure where hosts stay sovereign. ποΈ
Made with β€οΈ by Febin and the open-source community.
Enjoy! π