Essentia Mainnet is Live! Set-Up Guide

Oct 29, 2019 · 6 min read

The Essentia Mainnet is officially launched on October 28, 2019, when the first block was forged. Yesterday, we devoted all our efforts to running and testing it to make sure the network is working perfectly smooth and without any hitch. Today, we couldn’t be more delighted to announce that, thanks to the support of our community, we have hit the biggest milestone since the beginning of the project.

Essentia has always been passionate about providing our users with efficient solutions to simplify their blockchain technology leverage. Lead by this goal, during the last couple of years we have achieved great results, including the release of the Desktop and Mobile applications — manager allowing everyone to take their crypto lives wherever they go. It was truly an exciting journey seeing all the support and belief that our community has been showing through the years of development and growth. We managed to gather over 32k active users across all Essentia’s platforms, established more than 15 partnerships, and visited more than 20 significant events.

Now, we have come a step further. Our own blockchain.

Though it is a huge step towards the decentralized world we all dream about, it is only the beginning. We will continue working towards our goals, as well as refining, testing and updating the network we have put out. Stay tuned for the future ahead!

What is the Essentia blockchain?

Essentia is an open-source peer-to-peer network with Proof-of-Stake (PoS) consensus algorithm and masternode functionality focused on decentralization and real-world use.

PoS is a type of protocol that is used to create ESS that is distributed to stakers as a reward for validating transactions. The first 100 blocks of the Essentia blockchain are created via PoW, all next blocks — PoS.

In order to get more information about the state of the blockchain, remember you can always visit the Essentia block explorer.



  • Mercury masternode (allocation of 100,000 coins and more).
  • Mars masternode (allocations of 300,000 coins and more) — previously known as a Supernode. Available for private contributors only. If you are a pre-sale contributor wanting to set up a Mars masternode please contact us at

In order to install and run a node on your device, there are some basic requirements you need to meet. Those are:

Unix OS Ubuntu 16.04 and later
at least 2GB of memory.
at least 40GB hard drive.

In order to set up a masternode and participate in the Essentia network you will need:

  • To stake coins: you need to lock in a minimum of 10,000 coins in your wallet. The coins then cannot be spent or moved.
  • Computer Equipment or a Virtual server: you can dedicate a separate computer just for the masternode (though it is not a must) or set up a virtual server instead. One of the benefits of PoS as opposed to PoW is that you’re not forced to operate heavy hardware, but would be able to start earning node rewards with light equipment. Though, keep in mind that you’ll have to be connected to the internet at all times.
  • Internet: make sure that your Internet connection is fast enough to run a masternode, meaning keeping your copy of the blockchain constantly updated and being in contact with your peer nodes.

Note: To set up a node, you will have to firstly swap your tokens for coins. The token swap procedure will be available in just a few days. While we wait for that, make sure to get familiar with the detailed installation guide below.


How to set up the node on all platforms using Docker?

  1. The most preferred way of installing the Essentia node would be using the Docker. If you choose this way, then install the Essentia node via docker (for all platforms):

Install docker on windows (only for professional edition)

Install docker on Mac

Install docker on Linux

2. Open PowerShell program with admin privileges

(for other systems open terminal with root privileges)

and copy this command:

docker run — name essnode -d -p 8080:8080 -p 41312:41312 -p 41313:41313 devess/essd:latest

And press ‘Enter’.

To check if the node started successfully you can use this command:

docker ps

The output should be like this:

IMAGE devess/essd:latest

To connect to the node command-line interface use this command:

docker exec -it essnode bash

To stop the node use this command:

docker stop essnode

To start the node use this command:

docker start essnode

To copy files from a docker container, use this command:

docker cp essnode:<absolute file path> <local folder>

For example, to copy wallet.dat to the current local directory use this command:

docker cp essnode:/root/.ess/wallet.dat .

To copy files to the docker container from the local filesystem use this command:

docker cp <local file path> essnode:<absolute folder path>

For example, to copy wallet.dat to the current local directory use this command:

docker cp wallet.dat essnode:/root/.ess/

Note: To install the node on Windows home edition you can use Ubuntu subsystem installed on Windows and then set up the node following the guide or via docker.

How to set up a node on Linux OS?

1. Clone this repository.

git clone

2. Install required dependencies:

apt-get install git checkinstall build-essential libtool autotools-dev automake pkg-config libssl-dev libevent-dev bsdmainutils python3 libboost-system-dev libboost-filesystem-dev libboost-chrono-dev libboost-program-options-dev libboost-test-dev libboost-thread-dev libminiupnpc-dev libzmq3-dev libqt5gui5 libqt5core5a libqt5dbus5 qttools5-dev qttools5-dev-tools libprotobuf-dev protobuf-compiler libqrencode-dev libdb-dev libdb++-dev

3. Run next commands:

cd essx
export BDB_PREFIX="$(pwd)/contrib/db4"
cd contrib/ ; sh ./ . ; cd .. ;
./configure --disable-tests --with-unsupported-ssl --without-gui LDFLAGS="-L${BDB_PREFIX}/lib/" CPPFLAGS="-I${BDB_PREFIX}/include/"
make install

4. Edit file ~/.ess/ess.conf with your custom values:


5. Run node command:


How to set up a masternode via terminal on Linux OS

Note: Please ensure you have sufficient coins for running a masternode.

1. Make a collateral transaction to allocate funds using ess-cli tool. This transaction will cost 10 ESS coins.

ess-cli allocatefunds masternode mn23 marswhereallocatefunds — is command,masternode — purpose,mn23 — alias of masternode,mars — tier of masternode (Mercury or Mars).

The response to this command is a hash of the collateral transaction.

2. Wait until this transaction has 15 confirmations.

3. Run command:

ess-cli fundmasternode mn23 mars <hash_of_collateral_tx> <masternode_ip>


fundmasternode — is command,mn23 — alias of masternode,mars — tier of masternode,<hash_of_collateral_tx> — result of paragraph 1,<masternode_ip> — ip address of the remote server, where masternode will be running.

The result of this command will be a configuration:

mn23 <masternode_ip>:<port> <private_key> <hash_of_collateral_tx> <output_index>


mn23 — alias of masternode,<masternode_ip>:<port> ip address of the remote server, where masternode will be running,<private_key> — masternode private key,<hash_of_collateral_tx> — result of paragraph 1.

4. Stop the node via command: ess-cli stop.

5. Edit file masternode.conf:

Copy and paste the result of paragraph 3.

Now local node is configured.

6. Configure the remote node:

add the next lines to the file ess.conf:

from paragraph 3.

7. Start masternode.

On local (control) node run command: ess-cli startmasternode mn23


startmasternode — command,mn23 — masternode alias.

To check if it is successful, run command ess-cli listmasternodes. Masternode mn23 must be in the list of existing masternodes.

That’s it! Your masternode is up and running.

Here’s a little hint: the token swap is already being prepared, so stay tuned for more following announcements! If you have any questions regarding the mainnet set up, or anything related to the project, do not hesitate to reach us via our official Telegram channel!

Connect or Contribute

Website|Telegram | Twitter| Reddit

Essentia One

Essentia is the decentralized data management framework. Forged by a set of protocols. Forming Essences. Inside them, users own their data, identity and communications, enabling new powerful interactions.


Written by


Decentralized data management framework. With one seed, you can control all of your dApps, identities, and assets. Website:

Essentia One

Essentia is the decentralized data management framework. Forged by a set of protocols. Forming Essences. Inside them, users own their data, identity and communications, enabling new powerful interactions.

More From Medium

More on Cryptocurrency from Essentia One

More on Cryptocurrency from Essentia One

Blockexplorer Updated: What’s new?

Mar 18 · 3 min read


More on Bitcoin from Essentia One

More on Bitcoin from Essentia One

Essentia Staking Guide

Mar 10 · 3 min read

More on Tech from Essentia One

More on Tech from Essentia One

Essentia February ’20 Monthly Updates

Mar 2 · 3 min read


Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade