From a8cd1c324c0541b0d26542168aeced085ec13201 Mon Sep 17 00:00:00 2001
From: doc <doc@filenotfound.org>
Date: Mon, 30 Jun 2025 20:14:17 +0000
Subject: initial failzero commit

---
 README.md | 86 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 86 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8c0b26e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,86 @@
+# FailZero
+
+**FailZero** is a disaster resilience and ransomware recovery platform built by Genesis Hosting Technologies.
+
+We’re not here to sell you backups — we’re here to help you survive failure.  
+Whether it’s an encrypted drive, a botched update, or a full datacenter fire, FailZero ensures you have a path forward.
+
+> _"Hope is not a strategy. Recovery is."_ — FailZero Field Ops Manual
+
+---
+
+## 🛠 What It Does
+
+FailZero is designed for reactive and proactive DR (disaster recovery) workflows:
+
+- 🔁 **Live Backup & Mirroring** — Sync media, configs, and databases in near real-time
+- 🚨 **Ransomware Containment** — Immutable storage options + airgapped fallback
+- 💾 **Versioned Archives** — Roll back to any known good state
+- 🧩 **Hybrid Architecture** — Works with ZFS, MinIO, rclone, Samba, PostgreSQL, and more
+- 📦 **Disaster Drill Framework** — Simulate failure, validate recovery
+
+---
+
+## 📦 Core Components
+
+- `genesisctl` – unified CLI to manage snapshots, syncs, and alerts  
+- `GenesisTimer` – hourly integrity & latency monitor with alerts  
+- `dr_spl_overlay.sh` – SPL server resilience and fallback handler  
+- `krang_ops_bot` – Telegram integration for all alerts and status reports
+
+---
+
+## 🔐 Supported Services
+
+FailZero DR packages are available for:
+
+- 🎙️ **StationPlaylist** (SPL)
+- 📻 **AzuraCast**
+- 🐘 **Mastodon**
+- 📁 Any self-hosted Linux application with a filesystem and heartbeat
+
+---
+
+## 🚨 Example: Ransomware Workflow
+
+1. Primary storage compromised (e.g. `/mnt/ransom`)
+2. FailZero detects integrity drift or timeout
+3. Auto-switch to mirror: `/mnt/failzero`
+4. Alerts fired via Telegram, Web, or CLI
+5. Optional: Trigger airgapped restore from cold site
+
+---
+
+## 📄 Documentation
+
+The [FailZero Field Operations Manual](docs/FailZero_FieldOps.pdf) includes:
+
+- DR runbooks
+- Mock exercise scripts
+- Deployment guides
+- Legal disclaimers
+
+---
+
+## 💬 Contact
+
+Want to onboard or simulate a failure?
+
+- Telegram: [@krang_ops_bot](https://t.me/krang_ops_bot)
+- Email: `failzero@genesishostingtechnologies.com`
+- Status: [status.genesis-radio.net](https://status.genesis-radio.net)
+
+---
+
+## 💥 Warning
+
+> **FailZero is a disaster recovery tool, not a magic wand.**  
+> Regular testing, airgaps, and ops discipline are required to avoid data loss.
+
+---
+
+## License
+
+FailZero is © 2025 Genesis Hosting Technologies.  
+Usage and distribution subject to terms in `LICENSE`.
+
-- 
cgit v1.2.3