How to Build a Private Ethereum Network with Geth: Step‑by‑Step Guide

Why Use a Private Network?

Zero cost – Mine unlimited Ether locally without spending real funds.

Instant transactions – With only your own nodes, block confirmation is near‑instant.

Full control – Customize Chain ID, mining difficulty, gas limit, and other parameters.

Privacy – Test confidential logic in an isolated environment.

Prerequisite: Install Geth

Geth (Go Ethereum) is the official client for running Ethereum nodes. Download the binary for your operating system from https://geth.ethereum.org/downloads and install it.

Verify the installation: geth version If version information is displayed, Geth is ready.

Step 1 – Define the Genesis Block

Create a genesis.json file that describes the initial state of the chain. Key fields: config – Core chain configuration (Chain ID, fork activation blocks, consensus settings). difficulty – Low value (e.g., "0x1") for fast block production. gasLimit – Maximum gas per block. alloc – Pre‑allocate Ether to specific addresses for testing.

Example genesis.json :

{
  "config": {
    "chainId": 1337,
    "homesteadBlock": 0,
    "eip150Block": 0,
    "eip155Block": 0,
    "eip158Block": 0,
    "byzantiumBlock": 0,
    "constantinopleBlock": 0,
    "petersburgBlock": 0,
    "istanbulBlock": 0,
    "berlinBlock": 0,
    "clique": {"period": 5, "epoch": 30000},
    "terminalTotalDifficulty": 0
  },
  "difficulty": "0x1",
  "gasLimit": "0x8000000",
  "extradata": "0x...",
  "alloc": {
    "0x3F317E27Fe53Bc2803422710aEB51a259ddD0923": {"balance": "1000000000000000000000"}
  }
}

Replace the address in the alloc section with your own Ethereum address. The balance is expressed in Wei (1 ETH = 10¹⁸ Wei).

Step 2 – Initialize and Launch the Network

Create a data directory and initialize it with the genesis file:

mkdir my-private-eth
cd my-private-eth
geth --datadir . init genesis.json

After initialization the directory contains geth and keystore sub‑folders.

Start the private node with the following command:

geth --datadir . \
  --networkid 1337 \
  --http \
  --http.addr "0.0.0.0" \
  --http.api "eth,net,web3,admin,miner,txpool,debug" \
  --allow-insecure-unlock \
  --http.corsdomain "*" \
  --nodiscover

Parameter meanings: --networkid 1337 – Must match the chainId in genesis.json. --http – Enables the HTTP‑RPC interface. --http.api – Exposes the listed RPC modules. --http.corsdomain "*" – Allows cross‑origin requests from any origin. --nodiscover – Disables peer discovery, keeping the node isolated.

Step 3 – Interact with the Private Chain

Attach to the node’s JavaScript console: geth attach ipc:\\.\pipe\geth.ipc Check the pre‑allocated balance (replace the address with the one used in genesis.json):

eth.getBalance("0x3F317E27Fe53Bc2803422710aEB51a259ddD0923")
web3.fromWei(eth.getBalance("0x3F317E27Fe53Bc2803422710aEB51a259ddD0923"), "ether")

The console returns a large number representing the amount of Wei owned by that address.

Conclusion

Following these steps creates a fully functional private Ethereum network using Geth. The environment is fast, cost‑free, and isolated, making it suitable for developing, testing, and iterating smart contracts before deploying to public testnets or the mainnet.