summaryrefslogtreecommitdiff
path: root/README.md
blob: 8c0b26ee97455bffedc1f14280a76ee3a45251e8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
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`.