From b2605bbb758fc86be09c160bdb297f86bfd53cd1 Mon Sep 17 00:00:00 2001 From: Sonia Singla Date: Mon, 6 Jul 2026 23:37:56 +0200 Subject: [PATCH 1/2] clarify storage requirements and highlight 50 MB generator client --- content/generator/install/index.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/content/generator/install/index.md b/content/generator/install/index.md index 5a5cbda..077758c 100644 --- a/content/generator/install/index.md +++ b/content/generator/install/index.md @@ -7,6 +7,11 @@ This page covers installing a Shinzo Generator client with Docker or from source ## Hardware recommendations +The Shinzo Generator binary is approximately **50 MB**. Storage requirements depend on your node configuration: + +- **Pruned mode (recommended):** 50–100 GB NVMe +- **Archival mode:** 3+ TB NVMe + | Component | Minimum | Recommended | | --- | --- | --- | | CPU | 8 vCPUs | 16 vCPUs | From 06435304299a4dfd79e97a2bbd26bcc4c9680427 Mon Sep 17 00:00:00 2001 From: Sonia Singla Date: Tue, 7 Jul 2026 00:18:43 +0200 Subject: [PATCH 2/2] Consolidate and Standardize Hardware Requirements Across Documentation --- content/_index.md | 2 +- content/generator/faq/index.md | 8 ++++---- content/generator/install/index.md | 6 +++--- content/reference/components/host-client/index.md | 7 ++++--- content/reference/components/indexer-client/index.md | 6 +++--- 5 files changed, 15 insertions(+), 14 deletions(-) diff --git a/content/_index.md b/content/_index.md index 0911b29..e4de18b 100644 --- a/content/_index.md +++ b/content/_index.md @@ -66,7 +66,7 @@ Underneath all of this is [DefraDB](https://github.com/sourcenetwork/defradb), a ### Run a Generator client -If you already operate an Ethereum node, adding a Generator client is cheap. It's a sidecar, not a separate heavyweight service. It attaches to your existing execution client (currently only Geth, but support for other clients and chains is planned), reads blocks as they come in, signs them, and gossips them out over P2P. Recommended extra resources are around 4 CPU cores, 8 GB of RAM, and 100 GB of storage with pruning on, on top of whatever the node itself needs. +If you already operate an Ethereum node, adding a Generator client is straightforward. It’s a sidecar, not a separate heavyweight service. It attaches to your existing execution client (currently only Geth, with support for additional execution clients and chains planned), reads blocks as they come in, signs them, and gossips them over the P2P network. For the current testnet, the minimum recommended hardware is approximately 4 CPU cores, 8 GB of RAM and 300 GB of SSD storage. For the best experience, we recommend around 8 CPU cores, 16 GB of RAM, and 500 GB of NVMe storage. ### Run a Host diff --git a/content/generator/faq/index.md b/content/generator/faq/index.md index 21a7177..e009914 100644 --- a/content/generator/faq/index.md +++ b/content/generator/faq/index.md @@ -17,10 +17,10 @@ Shinzo is lightweight on CPU, but storage performance and host stability matter | Component | Minimum | Recommended | | --- | --- | --- | -| CPU | 2 vCPUs | 16 vCPUs | -| Memory (RAM) | 16 GB | 32–64 GB | -| Storage | 3 TB NVMe | 4+ TB NVMe | -| OS | Ubuntu 24.04 | Ubuntu 24.04 | +| CPU | ~4 cores | ~8 cores | +| Memory (RAM) | 8 GB | 16 GB | +| Storage | 300 GB | 500 GB | +| OS | Ubuntu 24.04 | Ubuntu 26.04 | ### Which RPC methods does the Generator client call on the upstream node? diff --git a/content/generator/install/index.md b/content/generator/install/index.md index 077758c..c65e38c 100644 --- a/content/generator/install/index.md +++ b/content/generator/install/index.md @@ -14,9 +14,9 @@ The Shinzo Generator binary is approximately **50 MB**. Storage requirements dep | Component | Minimum | Recommended | | --- | --- | --- | -| CPU | 8 vCPUs | 16 vCPUs | -| Memory (RAM) | 16 GB | 32–64 GB | -| Storage | 3 TB NVMe | 4+ TB NVMe | +| CPU | ~4 cores | ~8 cores | +| Memory (RAM) | 8 GB | 16 GB | +| Storage | 300 GB | 500 GB | | OS | Ubuntu 24.04 | Ubuntu 26.04 | ## Using Docker diff --git a/content/reference/components/host-client/index.md b/content/reference/components/host-client/index.md index a62ae9c..f15b643 100644 --- a/content/reference/components/host-client/index.md +++ b/content/reference/components/host-client/index.md @@ -242,9 +242,10 @@ Port 8080 exposes Prometheus metrics: block processing rates, attestation counts | Resource | Minimum | Recommended | | --- | --- | --- | -| CPU | 2 cores | 4 cores | -| RAM | 4 GB | 8 GB | -| Storage | 100 GB | 500 GB (depends on number of views) | +| CPU | 8 vCPUs | 16 vCPUs | +| Memory (RAM) | 16 GB | 32–64 GB | +| Storage | 3 TB NVMe | 4+ TB NVMe | +| OS | Ubuntu 24.04 | Ubuntu 24.04 | | Network | 100 Mbps | 1 Gbps | ## Key files diff --git a/content/reference/components/indexer-client/index.md b/content/reference/components/indexer-client/index.md index 8f81e39..3aca734 100644 --- a/content/reference/components/indexer-client/index.md +++ b/content/reference/components/indexer-client/index.md @@ -240,9 +240,9 @@ Bootstrap peers are configured in the DefraDB config. Peers are also discovered | Resource | Minimum | Recommended | | --- | --- | --- | -| CPU | 2 cores | 4 cores | -| RAM | 4 GB | 8 GB | -| Storage | 50 GB (with pruning) | 100 GB (with pruning) | +| CPU | ~4 cores | ~8 cores | +| RAM | 8 GB | 16 GB | +| Storage | 300 GB | 500 GB | | Network | 100 Mbps | 1 Gbps | ## Configuration