eth2-quickstart

Ethereum Node Quick Setup

Get an ETH2 compatible RPC node setup in seconds!
Save at least 2 days compared to CoinCashew and Somersats guides using the automated scripts and built-in checkpoint-sync configuration support.
With your own uncensored & unmetered RPC node!
And get ready for the ETH2 merge!

Setup an Ethereum node quickly with simple shell scripts containing community best practices. Supports multiple client combinations for servers, home solo stakers, and pool node operators. Choose from various execution and consensus clients for optimal client diversity.

⚠️ Security Notice: Don't blindly run scripts near sensitive data. Review scripts before execution.

Mission

We try to setup guidelines to quickly, safely and securely setup ETH2 capable nodes on a cloud VPS or bare metal server.

The goal is to allow sovereign individuals to set up independent validators, and validating services easily.
On their own hardware, in their own location, safe from government overreach and censorship.

Additionally, by using a VPS, they can more easily offer a censorship resistant RPC node for their fellow etherians.
(Do you really want to open up an RPC node on your home wifi for the world to use?)

Prerequisites

1. Server Setup: Cloud VPS with SSH key or local server

   • Recommended specs: 2-4+ TB SSD/NVMe, 16-64+ GB RAM, 4-8+ cores, Ubuntu 20+
   • Bare metal VPS preferred (cloud instances may not finish syncing)
   • SSH setup: Configure SSH keys and server access
   • Referral link: $20 free in cloud credits https://hetzner.cloud/?ref=d4Hoyi2u3pwn

2. System Configuration:

   • Set swraid 1 & swraidlevel 0 for full disk access
   • Note: SSH fingerprint changes after setup - remove from known_hosts

Quickstart

One-Liner Bootstrap (Recommended for fresh hosts)

curl -fsSL https://raw.githubusercontent.com/chimera-defi/eth2-quickstart/master/install.sh | sudo bash

• The bootstrap installer now auto-falls back to non-interactive defaults when run via a pipe.
• Force non-interactive explicitly:

curl -fsSL https://raw.githubusercontent.com/chimera-defi/eth2-quickstart/master/install.sh | sudo bash -s -- --non-interactive

• Force interactive TUI explicitly (requires a usable TTY):

curl -fsSL https://raw.githubusercontent.com/chimera-defi/eth2-quickstart/master/install.sh | sudo bash -s -- --interactive

Unified Command Wrapper (Human + Agent Friendly)

Use one stable entrypoint for common workflows:

./scripts/eth2qs.sh help
./scripts/eth2qs.sh configure --non-interactive
./scripts/eth2qs.sh client-options --json
./scripts/eth2qs.sh phase1
./scripts/eth2qs.sh phase2
./scripts/eth2qs.sh monad-install
./scripts/eth2qs.sh doctor --json
./scripts/eth2qs.sh debug --json --service cl
./scripts/eth2qs.sh stats --json
./scripts/eth2qs.sh update-check --json
./scripts/eth2qs.sh monitor export --json
./scripts/eth2qs.sh repair
./scripts/eth2qs.sh restart --smart

# Validator management (full guide: docs/VALIDATOR_MANAGEMENT.md)
./scripts/eth2qs.sh validators --json --withdrawal-type 0x01 --min-balance 32
./scripts/eth2qs.sh validator-deploy --num-validators 1 --withdrawal-type 0x02 --withdrawal-address 0xYourAddr
./scripts/eth2qs.sh validator-exit
./scripts/eth2qs.sh validator-withdrawal-changes          # 0x00 -> 0x01 (BLS-to-execution)
./scripts/eth2qs.sh validator-manage --consolidate        # EIP-7251 (incl. 0x01 -> 0x02 compounding)
./scripts/eth2qs.sh validator-manage --eip7002-exit       # EIP-7002 EL-triggered exit/withdrawal

For agent integrations, the published skill source lives at skills/eth2-quickstart/ and is intended to be used inside an eth2-quickstart checkout. The skill entrypoint is skills/eth2-quickstart/SKILL.md and includes operator, sizing, safety, and improvement references for agent users.

For External Agents

The skill is repo-aware: install it, then use it from inside an eth2-quickstart checkout.

# once published
clawhub install eth2-quickstart

# fallback: local workspace
git clone --depth 1 https://github.com/chimera-defi/eth2-quickstart.git
cd eth2-quickstart