Geth_setup

Chapter 7: Geth Client - Setup & Configuration

Overview

Geth (Go Ethereum) is the most popular and widely-used Ethereum client. It’s written in Go and developed by the Ethereum Foundation. Understanding Geth is essential for any blockchain infrastructure engineer.

---

7.1 Installing Geth

Prerequisites

Requirement	Minimum	Recommended
OS	Ubuntu 20.04+, macOS, Windows	Ubuntu 22.04 LTS
CPU	4 cores	8+ cores
RAM	8 GB	16-32 GB
Storage	1 TB SSD	2 TB NVMe SSD
Network	25 Mbps	100 Mbps

Installation Methods

Method 1: Download Binary (Recommended for Quick Start)

# Download latest Geth
cd /tmp
wget https://gethstore.blob.core.windows.net/builds/geth-linux-amd64-1.13.14-8ab7ff97.tar.gz
tar -xzf geth-linux-amd64-1.13.14-8ab7ff97.tar.gz
sudo mv geth-linux-amd64-1.13.14-8ab7ff97/geth /usr/local/bin/
rm -rf geth-linux-amd64-1.13.14-8ab7ff97*

# Verify installation
geth version

Method 2: Install from Source

# Install Go (if not installed)
wget https://go.dev/dl/go1.21.5.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.21.5.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin

# Clone and build Geth
git clone https://github.com/ethereum/go-ethereum.git
cd go-ethereum
make geth
sudo cp build/bin/geth /usr/local/bin/

Method 3: Using apt (Ubuntu/Debian)

sudo apt-get update
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:ethereum/ethereum
sudo apt-get update
sudo apt-get install geth

---

7.2 Basic Geth Commands

Quick Start

# Start Geth with default settings (connects to mainnet)
geth

# Start with console attached
geth console

# Check Geth version
geth version

Expected output:

Geth
Version: 1.13.14-8ab7ff97
Architecture: amd64
Protocol Versions: [68]
Network Protocols:
  Ethereum: 68
Go Version: go1.21.5
Operating System: linux
GOPATH=
GOROOT=/usr/local/go

---

7.3 Running a Full Node

Basic Full Node Command

geth \
  --syncmode full \
  --http \
  --http.addr 0.0.0.0 \
  --http.port 8545 \
  --http.api eth,net,web3,debug,txpool \
  --http.corsdomain "*" \
  --ws \
  --ws.addr 0.0.0.0 \
  --ws.port 8546 \
  --ws.api eth,net,web3 \
  --ws.origins "*" \
  --datadir /data/ethereum \
  --port 30303 \
  --maxpeers 50

Command Explanation

Flag	Description	Example
--syncmode	Synchronization mode	full, snap, light
--http	Enable HTTP-RPC server
--http.addr	HTTP server bind address	0.0.0.0 (all interfaces)
--http.port	HTTP server port	8545
--http.api	Enabled HTTP APIs	eth,net,web3
--ws	Enable WebSocket server
--ws.port	WebSocket port	8546
--datadir	Data directory path	/data/ethereum
--port	P2P networking port	30303
--maxpeers	Maximum peer connections	50

---

7.4 Important Sync Modes

Geth supports multiple synchronization modes:

┌─────────────────────────────────────────────────────────────────────────────┐
│                    GETH SYNC MODES                                          │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  ┌─────────────────┐                                                       │
│  │  FULL SYNC      │ ◄── Downloads and verifies every block                │
│  │                 │     Most secure, slowest initial sync                  │
│  └────────┬────────┘                                                       │
│           │                                                                 │
│  ┌────────▼────────┐                                                       │
│  │  SNAP SYNC      │ ◄── Downloads latest state, fastest                  │
│  │  (Default)      │     Recommended for most users                        │
│  └────────┬────────┘                                                       │
│           │                                                                 │
│  ┌────────▼────────┐                                                       │
│  │  LIGHT CLIENT   │ ◄── Only block headers + minimal data                │
│  │                 │     Fastest, limited functionality                     │
│  └─────────────────┘                                                       │
│                                                                              │
│  Recommendation: Use --syncmode snap for production nodes                   │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

Sync Mode Comparison

Mode	Initial Sync	Storage	Functionality	Security
Full	Days	~1.2 TB	Complete	Highest
Snap	Hours	~1.2 TB	Complete	High
Light	Minutes	~1 GB	Limited	Medium

---

7.5 Production Configuration

Optimized Production Flags

geth \
  --syncmode snap \
  --http \
  --http.addr 127.0.0.1 \
  --http.port 8545 \
  --http.api eth,net,web3,debug,txpool,erigon \
  --http.vhosts "*" \
  --ws \
  --ws.addr 127.0.0.1 \
  --ws.port 8546 \
  --ws.api eth,net,web3,debug,txpool,erigon \
  --ws.origins "*" \
  --datadir /data/ethereum \
  --port 30303 \
  --maxpeers 100 \
  --cache 4096 \
  --gc 1 \
  --txpool.globalslots 4096 \
  --txpool.globalqueue 1024 \
  --metrics \
  --metrics.addr 0.0.0.0 \
  --metrics.port 6060 \
  --pprof \
  --pprof.addr 0.0.0.0 \
  --pprof.port 6061

Configuration Parameters Explained

Parameter	Description	Recommended
--cache	Memory for caching (MB)	4096 (4GB)
--gc	Enable garbage collection	1
--txpool.globalslots	Max pending transactions	4096
--txpool.globalqueue	Max queued transactions	1024
--metrics	Enable Prometheus metrics
--pprof	Enable profiling API

---

7.6 Systemd Service Configuration

Create Systemd Service File

sudo nano /etc/systemd/system/geth.service

[Unit]
Description=Ethereum Geth Node
After=network.target
Wants=network-online.target

[Service]
Type=simple
User=ethereum
Group=ethereum
Restart=always
RestartSec=10
ExecStart=/usr/local/bin/geth \
  --syncmode snap \
  --http \
  --http.addr 127.0.0.1 \
  --http.port 8545 \
  --http.api eth,net,web3,debug,txpool \
  --ws \
  --ws.addr 127.0.0.1 \
  --ws.port 8546 \
  --ws.api eth,net,web3 \
  --datadir /data/ethereum \
  --port 30303 \
  --maxpeers 100 \
  --cache 4096 \
  --metrics \
  --pprof

# Hardening
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
ReadWritePaths=/data/ethereum

[Install]
WantedBy=multi-user.target

Enable and Start Service

# Reload systemd
sudo systemctl daemon-reload

# Create user and directories
sudo useradd -r -s /sbin/nologin ethereum
sudo mkdir -p /data/ethereum
sudo chown ethereum:ethereum /data/ethereum

# Enable and start
sudo systemctl enable geth
sudo systemctl start geth

# Check status
sudo systemctl status geth
sudo journalctl -fu geth -n 100

---

7.7 Docker Installation

Using Docker

# Pull Geth image
docker pull ethereum/client-go:latest

# Run Geth container
docker run -d \
  --name ethereum-node \
  -p 30303:30303 \
  -p 8545:8545 \
  -p 8546:8546 \
  -v /data/ethereum:/data \
  ethereum/client-go:latest \
  --syncmode snap \
  --http \
  --http.api eth,net,web3 \
  --datadir /data

Docker Compose

version: '3.8'

services:
  geth:
    image: ethereum/client-go:latest
    container_name: geth-node
    ports:
      - "30303:30303"
      - "8545:8545"
      - "8546:8546"
    volumes:
      - ./data:/data
    environment:
      - SYNCMODE=snap
    command:
      - --syncmode=snap
      - --http
      - --http.api=eth,net,web3
      - --datadir=/data
    restart: unless-stopped

---

7.8 Connecting to Testnet

Sepolia Testnet

geth \
  --sepolia \
  --syncmode snap \
  --http \
  --http.addr 127.0.0.1 \
  --http.port 8545 \
  --datadir /data/ethereum-sepolia

Goerli Testnet (Deprecated)

geth \
  --goerli \
  --syncmode snap \
  --http \
  --http.addr 127.0.0.1 \
  --http.port 8545 \
  --datadir /data/ethereum-goerli

Holesky (Validator Testnet)

geth \
  --holesky \
  --syncmode snap \
  --http \
  --http.addr 127.0.0.1 \
  --http.port 8545 \
  --datadir /data/ethereum-holesky

---

7.9 Checking Sync Status

Using Geth Console

geth attach http://localhost:8545

# Check sync status
eth.syncing

# Example output:
{
  currentBlock: 18500000,
  highestBlock: 18501234,
  knownStates: 123456,
  pulledStates: 120000,
  startingBlock: 18499000
}

# If false, node is synced
eth.syncing
# false

Using JSON-RPC

# Check block number
curl -X POST http://localhost:8545 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

# Check syncing status
curl -X POST http://localhost:8545 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'

---

7.10 Interview Questions

Question	Answer
How to check if Geth is synced?	Use eth.syncing in console - returns false when synced
Difference between sync modes?	Full = verify all; Snap = download state; Light = headers only
What port does Geth use?	30303 for P2P, 8545 for HTTP, 8546 for WebSocket
How to make node production-ready?	Use systemd, proper flags, monitoring

---

Summary

• Geth is the Go implementation of Ethereum
• Install via binary, source, or package manager
• Use --syncmode snap for fastest sync
• Configure HTTP/WebSocket APIs for dApp access
• Use systemd for production deployment
• Monitor sync status via RPC or console

---

Next Chapter

In Chapter 8: Geth CLI Options & Flags, we’ll explore all Geth command-line options in detail.

---

Last Updated: 2026-02-20