Featured image for How to Create Private Ethereum Blockchain?

// Blockchain

How to Create Private Ethereum Blockchain?

Are there any questions?
Yuri Musienko
Write to the expert
Featured image for How to Create Private Ethereum Blockchain?

In the article we will describe how to start Ethereum private blockchain with Geth, and also touch on the mechanics of Ethereum private networks.

What is Ethereum Private Network

Private Ethereum Blockchain Network

Ethereum private network is a private blockchain completely isolated from the main Ethereum network. Typically, private networks are created by organizations to store personal data that should not be visible to people outside the organization. In addition, the private network Ethereum can be used for testing and experiments with the blockchain.

Features of private Ethereum blockchain:

  1. The private network blockchain is not affiliated with the main Ethereum chain.
  2. Access to the network is limited to one or more nodes.
  3. Creating private Ethereum networks for free.
  4. The complexity of mining is set during the creation.
  5. Free transactions.

What is Ethereum Virtual Machine

Before proceeding with the practical part of our instructions, a few important points should be made regarding the Ethereum mechanism and what Geth is and how to use it.

Private Ethereum Blockchain EVM

Ethereum is an EVM network

If you do not go into the technical nuances, then we can say that Ethereum is a network of many nodes, or EVM (Ethereum Virtual Machine). EVM is software that can understand a set of instructions written according to certain rules (to start a transaction, smart contracts, applications) and execute them on the Ethereum network in a certain logical order, like a normal computer.

To start a private blockchain, your computer must become a node in the Ethereum network, that is, you need to download the entire blockchain network and synchronize it with the main chain of Ethereum. We can use various tools (client) for this, but we need those that allow us to interact with the blockchain network:

  1. Geth (Go Ethereum). The implementation of the Go (Golang) programming language for Ethereum is called Geth. This is one of the three initial implementations of the Ethereum protocol (along with Python and C ++). Choose this tool if you have at least minimal web development experience and want to experiment or create professional interfaces for dapps.
  2. Pyethapp. A Python-based client that implements the “Ethereum cryptoeconomic finite state machine”. You need to choose if you are interested in developing dapps or academic studies of the Ethereum network.
  3. C++ (eth). Ethereum implementation in C ++. Choose if you are serious about mining on the GPU or need to increase security by running two program implementations.
Using these tools, you can access the console (terminal) - a JavaScript environment containing all the basic functions that we will need later. Access to the console is the main thing you need to start the private Ethereum blockchain, so ultimately it’s not particularly important which tool you choose.

Private Ethereum Blockchain

Geth client interface
We chose Geth to write this guide because it is the most popular and relatively easy to use. Therefore, when it will be written later in the text that you need to write something in the console (terminal), it means that you need to do this with the help of Geth.

What is Geth (Go Ethereum)

Geth is a command line interface tool (CLI) that connects your system and equipment to the Ethereum network. With geth you can:
  • carry out financial transactions;
  • mine ether (utilitarian currency of the Ethereum network);
  • create smart contracts, decentralized applications;
  • create private blockchains;
  • explore the block history;
  • much more.
The client can be downloaded from geth.ethereum.org. There are builds for Ubuntu (Linux family), OS X (Apple devices), Windows and even Android. Instructions on what to do after downloading the distribution kit are located in the «Install» section (be sure to read and do everything written there).

How to create private blockchain Ethereum

After we have installed and synchronized Geth with Ethereum, we can start the launch of a “private” or “test” network. This is the best way to learn blockchain technologies, as you can create, deploy and test smart contracts and decentralized applications within the Ethereum private network without spending a single live ether. Moreover, you can create a “fake” ether and use it to carry out a transaction and initialize smart contracts.

Step 1: Create the DATADIR folder

When running your own blockchain, it is strongly recommended to use a separate folder for storing data (database and wallet) of a private network. This is necessary for Ethereum private network files. Do not replace files with a public one.

To do this, do the following:

1. Create an empty folder on your desktop. For example, with the name PrviaceChain3.

Private Ethereum Blockchain 1

2. Right-click on the created folder and select «Git Bash Here».

Private Ethereum Blockchain 2

3. If everything is ok, the system will show the following.

Private Ethereum Blockchain 3

Step 2: Create a genesis block

Private Ethereum Blockchain chains

Blockchain scheme: genesis-block, main and “side” chains

As you probably know, the blockchain is a distributed digital register in which all transactions are recorded in chronological order in the form of blocks. Blocks are generated during the mining process and added to the blockchain chain. The number of blocks is unlimited, but there is always one separate block that gave rise to the whole chain - the genesis-block.

To create a private blockchain, you first need to generate a genesis block. To do this, you need to create a Genesis file, write the necessary commands (attributes) into it and use it with Geth.

Here are the commands you need to register in the Genesis file:

Private Ethereum Blockchain Genesis Genesis

And this is what the attributes specified in it mean:

  • config. Defines the blockchain configuration. Does not set anything concrete for the genesis block itself, but determines how the network will work.
  1. chainId. The identifier used by the blockchain (something like an address). You can specify a random number, provided that it does not match the numbers of several important blockchains, for example, the Ethereum main chain number (1). The instruction contains a random three-digit identifier (777).
  2. homesteadBlock. Homestead is the first official stable version of the Ethereum protocol, which replaced the previous version called Frontier. If you plan to use this release, the attribute should be set to “0”.
  3. You can connect other protocols such as Byzantium, eip155B and eip158. To do this, under the homesteadBlock add the protocol name with the Block prefix (for example, eip158Block) and set the parameter “0” to them.
  • difficulty. Determines the difficulty of generating blocks. The higher the complexity, the more resources will be required for mining. To avoid waiting during tests and writing this text, we set a relatively low complexity value.
  • gasLimit. Indicates the current network-wide gas consumption limit per unit. Gas is the “fuel” that is used to pay transaction fees on the Ethereum network. The more gas a user is willing to spend, the higher the priority of his transaction in the queue. We set this value to a high enough level to avoid limitations during tests.
  • alloc. It allows you to create a cryptocurrency wallet for our private blockchain and fill it with fake ether. In our text, we will not use this option to show how to initiate mining on a private blockchain. If you are running a private blockchain to test a smart contract or a decentralized application, set the value you need (for example, 9999999999999).
You can create a Genesis file with the necessary attributes using any text editor, for example, Notepad (available in any version of Windows). The name of the genesis file can be any, the main thing is to specify the extension “json”. In our induction, the name CustomGenesis.json will be used.

After creating the Genesis file, open Geth and enter the following command:

Private Ethereum Blockchain command

This command instructs Geth to use the CustomGenesis.json file we previously created to generate the first block of the private blockchain Ethereum. The “path_to_folder” attribute is the folder where you saved the Genesis file. Whereas the attribute “path_to_your_data_directory” indicates the folder in which the data of our private chain will be stored (created in the first step).

When you run the specified attribute, you will see how Geth connects to the Genesis file and provides confirmation of the successful completion of the action. It will look like this:

Private Ethereum Blockchain action

Step 3: Start the private network

So, we have created a genesis block. Now you can run our private network so that we or other nodes (if you created several) can add new blocks. To do this, in the Geth console, you need to initiate the command:

Private Ethereum Blockchain launch

This command instructs Geth to launch a private blockchain. And use the specified directory ("path_to_your_data_directory" replace the address of the desired folder) to access the running network.

The command also has the identifier "7776". It should be replaced with an arbitrary number that is not equal to the identifier of the networks already created, for example, the identifier of the main network Ethereum ("networkid = 1"). The identifier "networkid = 7776" also should not be used, otherwise you will connect to the network we have created for this guide.

Here is a list of identifiers of the existing Ethereum blockchain networks:

Private Ethereum Blockchain identifier

When you initiate the specified command with YOUR identifier, you start your blockchain's private network. This is what the Geth terminal will show after successfully executing the command:

Private Ethereum Blockchain point

Another important point. Geth does not remember the parameters of your private blockchain network, so every time you want to access your private chain, you will need to run commands in the console that initiate a connection to the Genesis file and your private network. Keep them handy so you don’t look for them every time.

These two teams:

Private Ethereum Blockchain teams

If everything is done correctly, by this moment you will have a personal blockchain and a private Ethereum network. And now you can begin to interact with this chain.

Step 4: Create an externally owned account (EOA)

Private Ethereum Blockchain Types of accounts

Types of accounts in the Ethereum network

There are two types of accounts on the Ethereum network: Externally Owned Accounts (EOA) and Contracts Accounts. You can find out about their capabilities and differences in the “Types of accounts, gas and transactions” section on ethdocs.org. To manage our blockchain network, we need EOA. To create it, you need to run Geth in two windows. In the second window / console enter the following command:

Private Ethereum Blockchain window

This will connect the second window to the terminal of the first window (make sure it really happened - it all worked). If everything is correct, the terminal will display the following:

Private Ethereum Blockchain terminal matches

If the image on your terminal matches the screenshot in the instructions, you can create an account. To do this, in the second window enter the command:

Private Ethereum Blockchain command

Next you will be asked to set a password, the introduction of which initiates the creation of an account. It looks like this.

Save the created account (a long set of characters in the screenshot), as you will use it often. In addition, save the passphrase because it will be needed every time you connect to your account.

Next, we need to check the balance status of the account (how much ether is there). To do this, use the following command:

Private Ethereum Blockchain balance status

That's what you should do:

Private Ethereum Blockchain zero

Account balance must be zero. This is correct, because when starting a private network in the genesis file, we did not specify anything in the alloc attribute. You can replenish the balance now in two ways: either someone will send you a little ether, or you will receive a reward for creating a new unit. And since you are now the only member of your private network, you have in fact, no choice.

Step 5: Get some ether for our account

Mining on the main chain of Ethereum (real) is complex and requires expensive equipment with powerful graphics processors. Usually ASICs are used for this. However, for the mining of coins of our chain, any device will be suitable, since in the genesis file we set the mining difficulty low (difficulty attribute). In other words, we can start mining just by using the following command:

Private Ethereum Blockchain following command

The result should be:

Private Ethereum Blockchain eth.getBalance

If you use the eth.getBalance command in the second Geth window, you will see how the balance of your account is replenished with a fake ether. The speed of mining will be very high, so you can become a multimillionaire in just a couple of seconds.

Private Ethereum Blockchain money

When there is enough money, use the following command to stop mining:

Private Ethereum Blockchain stop mining

And remember that this is a fake ether. It can only be used within your private blockchain for testing transactions, smart contracts, decentralized applications and other functions.


You created your first private Ethereum blockchain and got some ether! Yes, this is not real money and a test network, but the experience gained can be used to launch startups or integrate blockchain technologies into your own business.

The Merehead company develops blockchain-based platforms. Our experts have extensive experience in building complex high-load projects. As a rule, we use Ethereum and Bitcoin nodes. But we use Hyperledger Fabric or Corda to develop more flexible solutions.

Merehead does professional development of Private Ethereum Blockchain. If you have questions, contact us for a free consultation.

How can we help you?

Full name *
Email *
Your budget
Tell us about your project
Merehead review. Vleppo is a startup, digital asset exchange platform based on the Komodo blockchain protocol.

  Category: Blockchain 02/13/2023
How to Use Blockchain for Identity Management?
"As many of you experience every day, the world is undergoing a global digital transformation where digital and physical reality are blurring into a single integrated modern way of living. This new world needs a new model for digital identity, one that enhances individual privacy and security across the physical and digital world," says Alex Simons, Microsoft's Director of Program Management, in his blog post.
  Category: Blockchain 11/07/2022
When You Shoud to Use a Blockchain Technology - Do You Really Need It?
So, you've decided to get yourself a nice blockchain-based business? Congrats! But would you mind answering the following questions:
  Category: Blockchain 02/13/2023
Best Blockchain Use Cases That Made Companies Stronger
Blockchain is the technology that, like the Internet in its time, will change a great part of modern business. How it will be, what problems the control register will solve and what benefits the entrepreneur will receive – read in this article.