Skip to main content

How to Run a BNB Smart Chain Node

Updated on
Jul 3, 2023

7 min read


BNB Smart Chain, BSC for short, is a blockchain that seeks to provide both an alternative and extension to the Ethereum Blockchain. It has done this through several clever implementations that took place during the building of the platform. This guide will walk you through the process of how to run your very own BSC node.


Taken from the BNB Smart Chain docs for node requirements 

  • VPS running recent versions of Mac OS X or Linux
  • IMPORTANT 2TB of free disk space, solid-state drive(SSD), gp3, 8k IOPS, 250MB/S throughput, read latency <1ms. (if start with snap/fast sync, it will need NVMe SSD)
  • 16 cores of CPU and 64 gigabytes of memory (RAM)
  • Suggest m5zn.3xlarge instance type on AWS, c2-standard-16 on Google cloud
  • A broadband Internet connection with upload/download speeds of 5 megabyte per second

What is BNB Smart Chain?

Great question! BSC is a standalone blockchain designed to take some of the mature tools from the Ethereum Ecosystem, such as the Ethereum Virtual Machine (EVM). It took this singular block from Ethereum and built on top of it with a few goals in mind. 

It wanted to be more environmentally friendly; it accomplished this by moving the consensus protocol to a blend of Proof-of-Authority and Delegated Proof of Stake. They named this new protocol "Proof of Staked Authority." The designers of BSC also wanted their new blockchain to be more performant than its Ethereum cousin. 

The project's overall goals were to reduce blocking time, shorten time to confirm transactions, use a staking-based governance network, and achieve cross-compatibility with Ethereum. BSC launched its mainnet in April of 2019.

If you would like more details on what influenced the design and decisions of those who made the system or the underlying algorithms, you should their white paper.

What Nodes Do

Perhaps after seeing the BNB Smart Chain's goals, you want to participate in the network. To accomplish this noble deed, you need to run a BSC Full Node. There are two different kinds of Full Nodes: Witness Nodes and Validator Nodes. 

Witness Nodes observe but do not participate in the consensus process. They serve to duplicate data and work as additional messengers in the network to serve up the current chain state. 

Validator Nodes on the other hand, do everything that Witness Nodes do, but they also are responsible for validating the transactions. In addition to the transaction validation, they also work to produce new blocks. You can imagine Validator Nodes as the counterpart to an Ethereum/Bitcoin "miner." In the next section, I will walk you through how to setup and run a Witness Node.

Configuring the Project

The process of running a Validator Node compared to a Witness Node is similar. In this guide, we will be running a Witness Node as it is more accessible. This is because hardware requirements for a Validator Node are higher than its Witness Node sibling. You can find hardware requirements for both here.

All of the following commands should be done in your VPS and not your local machine.

The first thing you will need to do is install a recent version of Go.

Here are the commands to install Golang on a Linux  64-bit system:

## set your GOPATH
export PATH=$PATH:/usr/local/go/bin
## confirm it works by running
go version

After installing Go you will want to set up your project directory. Run the following command to do so:

git clone 
cd bsc
make geth

The next thing you will need to do is download a snapshot of the most up-to-date chain data and place it in your home folder.  You can find the data here.  After you have it downloaded, you will run the following command substituting the "NAME_OF_YOUR_HOME" with your home directory.

unzip -d /NAME_OF_YOUR_HOME/node &

The snapshot will considerably speed up your node's syncing; BSC nodes are enormous compared to other blockchain nodes. It could take weeks to sync a node to tip if you didn't perform this step.

With your project directory up and snapshot downloaded, you will now download the config files and set them up.

The commands below will download the relevant files depending on whether you want to run a  node on the mainnet or testnet.

## mainet
## testnet

This will extract a config.toml and a genesis.json file into your project directory.

How to run a Witness Node

With all of the initial configuration done, its time to run a node!
The next step is to write your genesis state onto your VPS with the following command.

geth --datadir node init genesis.json

Upon running the command above you should see an output similar to this:

INFO [07-02|18:28:08.337] Maximum peer count                       ETH=50 LES=0 total=50
INFO [07-02|18:28:08.337] Smartcard socket not found, disabling err="stat /run/pcscd/pcscd.comm: no such file or directory"
INFO [07-02|18:28:08.337] Set global gas cap cap=50,000,000
INFO [07-02|18:28:08.337] Allocated cache and file handles database=/root/bsc/node/geth/chaindata cache=16.00MiB handles=16
INFO [07-02|18:28:08.353] Persisted trie from memory database nodes=15 size=2.32KiB time="70.575µs" gcnodes=0 gcsize=0.00B gctime=0s livenodes=1 livesize=0.00B
INFO [07-02|18:28:08.353] Successfully wrote genesis state database=chaindata ha=0d2184..d57b5b
INFO [07-02|18:28:08.354] Allocated cache and file handles database=/root/bsc/node/geth/lightchaindata cache=16.00MiB handles=16
INFO [07-02|18:28:08.366] Persisted trie from memory database nodes=15 size=2.32KiB time="29.71µs" gcnodes=0 gcsize=0.00B gctime=0s livenodes=1 livesize=0.00B
INFO [07-02|18:28:08.366] Successfully wrote genesis state database=lightchaindata ha=0d2184..d57b5b

After running the command above, you will open your config.toml file and replace it with the following:

NetworkId = 56
NoPruning = false
NoPrefetch = false
LightPeers = 100
UltraLightFraction = 75
TrieTimeout = 100000000000
EnablePreimageRecording = false
EWASMInterpreter = ""
EVMInterpreter = ""

GasFloor = 30000000
GasCeil = 40000000
GasPrice = 1000000000
Recommit = 10000000000
Noverify = false

Locals = []
NoLocals = true
Journal = "transactions.rlp"
Rejournal = 3600000000000
PriceLimit = 1000000000
PriceBump = 10
AccountSlots = 512
GlobalSlots = 10000
AccountQueue = 256
GlobalQueue = 5000
Lifetime = 10800000000000

IPCPath = "geth.ipc"
HTTPHost = "localhost"
NoUSB = true
InsecureUnlockAllowed = false
HTTPPort = 8545
HTTPVirtualHosts = ["localhost"]
HTTPModules = ["eth", "net", "web3", "txpool", "parlia"]
WSPort = 8546
WSModules = ["net", "web3", "eth"]

MaxPeers = 30
NoDiscovery = false
BootstrapNodes = ["enode://1cc4534b14cfe351ab740a1418ab944a234ca2f702915eadb7e558a02010cb7c5a8c295a3b56bcefa7701c07752acd5539cb13df2aab8ae2d98934d712611443@","enode://28b1d16562dac280dacaaf45d54516b85bc6c994252a9825c5cc4e080d3e53446d05f63ba495ea7d44d6c316b54cd92b245c5c328c37da24605c4a93a0d099c4@","enode://5a7b996048d1b0a07683a949662c87c09b55247ce774aeee10bb886892e586e3c604564393292e38ef43c023ee9981e1f8b335766ec4f0f256e57f8640b079d5@"]
StaticNodes = ["enode://f3cfd69f2808ef64838abd8786342c0b22fdd28268703c8d6812e26e109f9a7cb2b37bd49724ebb46c233289f22da82991c87345eb9a2dadeddb8f37eeb259ac@","enode://ae74385270d4afeb953561603fcedc4a0e755a241ffdea31c3f751dc8be5bf29c03bf46e3051d1c8d997c45479a92632020c9a84b96dcb63b2259ec09b4fde38@","enode://d1cabe083d5fc1da9b510889188f06dab891935294e4569df759fc2c4d684b3b4982051b84a9a078512202ad947f9240adc5b6abea5320fb9a736d2f6751c52e@","enode://f420209bac5324326c116d38d83edfa2256c4101a27cd3e7f9b8287dc8526900f4137e915df6806986b28bc79b1e66679b544a1c515a95ede86f4d809bd65dab@","enode://c0e8d1abd27c3c13ca879e16f34c12ffee936a7e5d7b7fb6f1af5cc75c6fad704e5667c7bbf7826fcb200d22b9bf86395271b0f76c21e63ad9a388ed548d4c90@","enode://f1b49b1cf536e36f9a56730f7a0ece899e5efb344eec2fdca3a335465bc4f619b98121f4a5032a1218fa8b69a5488d1ec48afe2abda073280beec296b104db31@","enode://4924583cfb262b6e333969c86eab8da009b3f7d165cc9ad326914f576c575741e71dc6e64a830e833c25e8c45b906364e58e70cdf043651fd583082ea7db5e3b@","enode://4d041250eb4f05ab55af184a01aed1a71d241a94a03a5b86f4e32659e1ab1e144be919890682d4afb5e7afd837146ce584d61a38837553d95a7de1f28ea4513a@","enode://b5772a14fdaeebf4c1924e73c923bdf11c35240a6da7b9e5ec0e6cbb95e78327690b90e8ab0ea5270debc8834454b98eca34cc2a19817f5972498648a6959a3a@","enode://f329176b187cec87b327f82e78b6ece3102a0f7c89b92a5312e1674062c6e89f785f55fb1b167e369d71c66b0548994c6035c6d85849eccb434d4d9e0c489cdd@","enode://cbfd1219940d4e312ad94108e7fa3bc34c4c22081d6f334a2e7b36bb28928b56879924cf0353ad85fa5b2f3d5033bbe8ad5371feae9c2088214184be301ed658@","enode://c64b0a0c619c03c220ea0d7cac754931f967665f9e148b92d2e46761ad9180f5eb5aaef48dfc230d8db8f8c16d2265a3d5407b06bedcd5f0f5a22c2f51c2e69f@","enode://352a361a9240d4d23bb6fab19cc6dc5a5fc6921abf19de65afe13f1802780aecd67c8c09d8c89043ff86947f171d98ab06906ef616d58e718067e02abea0dda9@","enode://bb683ef5d03db7d945d6f84b88e5b98920b70aecc22abed8c00d6db621f784e4280e5813d12694c7a091543064456ad9789980766f3f1feb38906cf7255c33d6@","enode://11dc6fea50630b68a9289055d6b0fb0e22fb5048a3f4e4efd741a7ab09dd79e78d383efc052089e516f0a0f3eacdd5d3ffbe5279b36ecc42ad7cd1f2767fdbdb@","enode://21530e423b42aed17d7eef67882ebb23357db4f8b10c94d4c71191f52955d97dc13eec03cfeff0fe3a1c89c955e81a6970c09689d21ecbec2142b26b7e759c45@","enode://d61a31410c365e7fcd50e24d56a77d2d9741d4a57b295cc5070189ad90d0ec749d113b4b0432c6d795eb36597efce88d12ca45e645ec51b3a2144e1c1c41b66a@","enode://bb91215b1d77c892897048dd58f709f02aacb5355aa8f50f00b67c879c3dffd7eef5b5a152ac46cdfb255295bec4d06701a8032456703c6b604a4686d388ea8f@","enode://786acbdf5a3cf91b99047a0fd8305e11e54d96ea3a72b1527050d3d6f8c9fc0278ff9ef56f3e56b3b70a283d97c309065506ea2fc3eb9b62477fd014a3ec1a96@","enode://4653bc7c235c3480968e5e81d91123bc67626f35c207ae4acab89347db675a627784c5982431300c02f547a7d33558718f7795e848d547a327abb111eac73636@","enode://c6ffd994c4ef130f90f8ee2fc08c1b0f02a6e9b12152092bf5a03dd7af9fd33597d4b2e2000a271cc0648d5e55242aeadd6d5061bb2e596372655ba0722cc704@","enode://99b07e9dc5f204263b87243146743399b2bd60c98f68d1239a3461d09087e6c417e40f1106fa606ccf54159feabdddb4e7f367559b349a6511e66e525de4906e@","enode://1479af5ea7bda822e8747d0b967309bced22cad5083b93bc6f4e1d7da7be067cd8495dc4c5a71579f2da8d9068f0c43ad6933d2b335a545b4ae49a846122b261@","enode://43562d35f274d9e93f5ccac484c7cb185eabc746dbc9f3a56c36dc5a9ef05a3282695de7694a71c0bf4600651f49395b2ee7a6aaef857db2ac896e0fcbe6b518@","enode://08867e57849456fc9b0b00771f53e87ca6f2dd618c23b34a35d0c851cd484a4b7137905c5b357795025b368e4f8fe4c841b752b0c28cc2dbbf41a03d048e0e24@"]
ListenAddr = ":30311"
EnableMsgEvents = false

ReadTimeout = 30000000000
WriteTimeout = 30000000000
IdleTimeout = 120000000000

One thing to note here is if you already know of several other reliable nodes you may place them under the StaticNodes array. Any nodes in this array will be connected to automatically upon booting up of the node.

Then to start your Witness node you will run the following command.

## start a full node
geth --config ./config.toml --datadir ./node --cache 18000 --rpc.allow-unprotected-txs --txlookuplimit 0

If you have the hardware requirements running the following will run a Validator Node instead of a Witness Node:

## generate the consensus key and input the password
geth account new --datadir ./node echo {your-password} > password.txt
geth --config ./config.toml --datadir ./node --syncmode snap -unlock {your-validator-address} --password password.txt --mine --allow-insecure-unlock --cache 18000

After running these you should see in your terminal's logs that you are starting to look for peers, and will begin syncing to their data. You will need some patience after running this command, as it can take several hours to sync a node all the way to tip.


Congratulations! If all of the steps were followed, and you were able to connect to other peers to sync your node, you will be successfully running your own BSC Full Node. Depending on your local region you may find it easier or harder to find peers to share data with to sync your chain all the way to tip. The key in this process is patience.

If you let the program run its course you should eventually find success. You are now the master of your own blockchain destiny. You can send transactions to be confirmed to the blockchain without relying on others, as you can route all of your traffic to the node that you are personally running!

Subscribe to our newsletter for more articles and guides on Ethereum. If you have any feedback, feel free to reach out to us via Twitter. You can always chat with us on our Discord community server, featuring some of the coolest developers you’ll ever meet :)

Share this guide