Skip to content

docs: recommend musl and 128 GB swap for validators #540

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kp2pml30 wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: recommend musl and 128 GB swap for validators #540

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion pages/validators/setup-guide.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,14 +17,17 @@ For a deeper understanding of how staking works in GenLayer, see the [Staking do
| Resource | Requirement |
|----------|-------------|
| **Memory** | 16 GB RAM |
| **Swap** | 128 GB recommended, in addition to RAM |
| **CPU** | 8-core (AMD64 only) |
| **Disk** | 128 GB SSD/NVMe |
| **Disk** | 128 GB SSD/NVMe (excluding swap) |
| **Network** | 100 Mbps |
| **OS** | 64-bit Linux |
| **Software** | Docker, Python 3 (with pip and venv) |

GPU not required unless running LLMs locally. See [detailed requirements](/validators/system-requirements) for more info.

We recommend 128 GB of swap as a conservative starting point while transaction throughput and memory demand are not yet known. On Linux, we also recommend [installing musl libc](/validators/system-requirements#musl-libc-recommended-on-linux) for GenVM's default ELF interpreter

## Choose Your Setup Method

GenLayer offers two ways to set up your validator node. Both methods result in the same configuration—choose the one that fits your workflow.
Expand Down
26 changes: 25 additions & 1 deletion pages/validators/system-requirements.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,12 @@ System Requirements for a GenLayer validator node are the **initial** recommende
- GenLayer's _genvm_ can spawn multiple Sub-VMs for contract calls and non-deterministic blocks.
- Each Sub-VM can consume up to ~4 GB of RAM for storage.

## Swap

- **Recommended:** 128 GB of swap, in addition to the recommended RAM
- **Why:** Transaction throughput and the resulting memory demand are not yet known, so size swap conservatively to provide headroom for memory spikes
- Monitor RAM and swap usage as network load becomes clearer; sustained swapping can slow transaction execution

## CPU

- **Recommended:** Modern multi-core processor with at least 8 cores/16 threads
Expand All @@ -25,7 +31,7 @@ System Requirements for a GenLayer validator node are the **initial** recommende

## Storage

- **Recommended Disk Space:** 128 GB+
- **Recommended Disk Space:** 128 GB+ (excluding swap)
- **Preferred Type:** SSD or NVMe (M.2)

## Network
Expand All @@ -49,3 +55,21 @@ System Requirements for a GenLayer validator node are the **initial** recommende
- Operating System - 64-bit Linux (Ubuntu, Debian, CentOS, etc.)
- `docker` - for running the WebDriver container
- `python3`, `python3-pip` and `python3-venv` for GenVM setup

### musl libc (Recommended on Linux)

We recommend installing musl libc on Linux so GenVM binaries can use their default ELF interpreter path. On Ubuntu or Debian:

```bash copy
sudo apt-get update
sudo apt-get install -y musl
```

For other Linux distributions, install the musl runtime package using your distribution's package manager. Check that the interpreter for your architecture exists and is executable:

| Architecture | Default ELF Interpreter Path |
|--------------|------------------------------|
| AMD64 (`x86_64`) | `/lib/ld-musl-x86_64.so.1` |
| ARM64 (`aarch64`) | `/lib/ld-musl-aarch64.so.1` |

The AArch64 path is provided as a GenVM reference; validator nodes currently support AMD64 only
Loading