Skip to content

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

Open
kp2pml30 wants to merge 1 commit into
mainfrom
docs/validator-musl-swap
Open

kp2pml30 wants to merge 1 commit into
mainfrom
docs/validator-musl-swap

Conversation

@kp2pml30

@kp2pml30 kp2pml30 commented Sep 17, 2026 •

Copy link
Copy Markdown
Member

Recommend musl libc on Linux and document GenVM's default ELF interpreter paths for AMD64 and AArch64, preserving the current AMD64-only validator support statement

Recommend 128 GB of swap as a conservative starting point while transaction throughput and memory demand are unknown. Keep the existing 128 GB disk recommendation and clarify that it excludes swap. Update both the requirements page and setup summary

Validation

  • Both changed pages compile with Nextra
  • The musl section link resolves to the generated heading anchor
  • Independent review found no issues; the final disk wording was recompiled after review
  • git diff --check passed

Documentation only; no full site build or E2E requested

Summary by CodeRabbit

  • Documentation
    • Updated validator system requirements to include a recommended 128 GB of swap space.
    • Clarified that disk space recommendations exclude swap.
    • Added swap monitoring guidance.
    • Added Linux musl libc installation guidance and default ELF interpreter paths for supported architectures.

@kp2pml30 kp2pml30 self-assigned this Sep 17, 2026
@coderabbitai

coderabbitai Bot commented Sep 17, 2026 •

Copy link
Copy Markdown
Contributor

Review Change StackReview Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 00701c9a-5fc5-46dc-8824-d60652aed816

📥 Commits

Reviewing files that changed from the base of the PR and between 1cd8e2d and e8cb713.

📒 Files selected for processing (2)
  • pages/validators/setup-guide.mdx
  • pages/validators/system-requirements.mdx

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

The validator documentation adds swap requirements, clarifies storage requirements, and documents musl libc installation and ELF interpreter paths for GenVM.

Changes

Validator requirements

Layer / File(s) Summary
Resource and storage requirements
pages/validators/setup-guide.mdx, pages/validators/system-requirements.mdx
The documentation recommends 128 GB of swap, adds monitoring guidance, and clarifies that storage excludes swap.
Linux musl libc setup
pages/validators/system-requirements.mdx
The documentation adds installation commands, package-manager guidance, and ELF interpreter paths for AMD64 and ARM64. It notes that validator nodes currently support AMD64 only.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~5 minutes

Change: Other

Suggested reviewers: dohernandez

Merge Risk: ⚪ Minimal · up to e8cb7

The documentation changes are mergeable with no established blocking issue.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description check ✅ Passed The description clearly explains the documentation changes, affected pages, validation performed, and scope. It meets the required description structure.
Title check ✅ Passed The title uses the Conventional Commits format and clearly summarizes the main documentation changes: the musl recommendation and 128 GB swap guidance for validators.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/validator-musl-swap

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@netlify

netlify Bot commented Sep 17, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for genlayer-docs ready!

Name Link
🔨 Latest commit e8cb713
🔍 Latest deploy log https://app.netlify.com/projects/genlayer-docs/deploys/6aabbf7d5a4bd10008717513
😎 Deploy Preview https://deploy-preview-540--genlayer-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@kp2pml30
kp2pml30 marked this pull request as ready for review September 17, 2026 10:30

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant