Setting Up an Ethereum Private Network on a Single Node

Introduction to Ethereum

Ethereum is an open-source project renowned for its Turing-complete smart contract functionality, enabling decentralized applications (dApps) to operate on its blockchain.

Installation Steps

Ethereum Homestead documentation lists several client options. This guide focuses on go-ethereum (geth), the most widely used implementation.

Installing Ethereum

Ubuntu

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

macOS

brew tap ethereum/ethereum
brew install ethereum

Creating the Genesis Block

Every blockchain requires a genesis block. This example configures a private chain (not connected to Ethereum's mainnet).

Create genesis.json with the following content:

{
  "config": {
    "chainId": 15,
    "homesteadBlock": 0,
    "eip155Block": 0,
    "eip158Block": 0
  },
  "difficulty": "200000000",
  "gasLimit": "2100000",
  "alloc": {
    "7df9a875a174b3bc565e6424a0050ebc1b2d1d82": { "balance": "300000" },
    "f41c74c9ae680c1aa78f42e5647a62f353b7bdde": { "balance": "400000" }
  }
}

Initialize the private chain using:
```
geth init genesis.json
```

Running Geth

Execute the following command to start your node:

geth --networkid 9487 \
  -rpc \
  --rpcaddr "0.0.0.0" \
  --rpccorsdomain "*" \
  --rpcapi "admin,db,eth,debug,miner,net,shh,txpool,personal,web3" \
  console

Parameter Breakdown:

networkid: Ensures nodes can connect if expanded to a multi-node network.
rpc: Activates the HTTP-RPC server.
rpcaddr "0.0.0.0": Allows external RPC connections (default: localhost).
rpccorsdomain "*": Enables Cross-Origin Resource Sharing (CORS).
rpcapi: Exposes APIs for testing (e.g., miner, personal).

👉 Learn more about Ethereum node configuration

Key Considerations for Private Networks

ChainID: Use a unique value (e.g., 15) to avoid conflicts with mainnet/testnets.
Difficulty: Lower values (e.g., 200000000) speed up block mining for testing.
Gas Limit: Adjust based on transaction complexity (default: 2100000).

FAQ Section

1. Why choose go-ethereum (geth)?

Geth is the most actively maintained Ethereum client, offering robust features for developers and enterprises.

2. How secure is a private Ethereum network?

Private networks are isolated from mainnet risks but require manual security configurations (e.g., node permissions).

3. Can I connect multiple nodes later?

Yes. Use the same genesis.json and networkid across nodes, and configure peer connections via admin.addPeer().

👉 Explore advanced Ethereum network setups