Skip to content

docs: add practical node operation guide#993

Open
Kubudak90 wants to merge 1 commit intobase:mainfrom
Kubudak90:docs-practical-guide
Open

docs: add practical node operation guide#993
Kubudak90 wants to merge 1 commit intobase:mainfrom
Kubudak90:docs-practical-guide

Conversation

@Kubudak90
Copy link
Copy Markdown

Summary

This PR adds a comprehensive practical node operation guide to the README, addressing common questions from node operators.

Changes

  • Added storage requirements table comparing Archive vs Full (pruned) nodes
  • Included sync time estimates and use case recommendations
  • Added quick start commands for both node types
  • Included maintenance commands (logs, updates, monitoring)
  • Added troubleshooting section for common issues

Why

The current README provides hardware specs but lacks practical guidance on:

  • Which node type to choose
  • How long sync takes
  • How to actually start and maintain a node

This guide helps operators make informed decisions and operate nodes effectively.

Add comprehensive guide addressing common operator concerns:
- Storage requirements by node type (Archive vs Full)
- Realistic sync time estimates
- Storage performance comparisons (SSD vs HDD)
- Sync options with pros/cons
- Snap sync status
- Alternatives for individual operators
- Monitoring commands
- Troubleshooting tips

Addresses concerns raised in base#990 about realistic expectations
for individual node operators.
@cb-heimdall
Copy link
Copy Markdown
Collaborator

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 1
Sum 2

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.

2 participants