Compile from source
# Mac OS: brew install protobuf # Ubuntu: apt install protobuf-compiler
curl https://sh.rustup.rs -sSf | sh rustup component add clippy-preview rustup default nightly
2. Clone repository
We would need to copy the entire repository:
git clone https://github.com/nearprotocol/nearcore cd nearcore
3. Compile and run
Navigate to the root of the repository, and run:
cargo run --package near -- init cargo run --package near -- run
This will setup a local chain with
init and will run the node.
You can now check the status of the node with
http tool (
brew install http or
apt install http or configure CURL for POST requests) via RPC:
http get http://localhost:3030/status http post http://localhost:3030/ method=query jsonrpc=2.0 id=1 params:='["account/test.near", ""]'
See full list of RPC endpoints here
Unfortunately, transactions needs to be signed and encoded in base64, which is hard to do from the command line. Use
near-shell tool to manage keys and send transactions (
npm install -g near-shell).
To run NEARCore node in the testing mode, for example to test it or for development of
near-shell you can use scripts that sets up special tests-only local testnet:
This sets up a new single node testnet, with predetermined private key of the validator and turns on "fast" mode of block production to make development and testing easy.
Many times in development of the node it's useful to see detailed logs about what is happening.
near binary has
--verbose mode to show more details about what is happening:
cargo run -p near -- --verbose run
You can also use the
RUST_LOG environment variable, with
env_logger semantics to override the log level for specific targets.
RUST_LOG can also be used in integration tests which spawn runnable apps.
If you want to change what is logged in verbose mode / non-verbose mode, for example to add new target (e.g.
info!(target: "my target", "hello")), modify
This section describes how to prepare releases and publish docker files for NEAR core client.
Build docker container
To build docker image run from the root:
This will build an image with
Publishing Docker files
To publish docker image, use
sudo docker tag nearcore <your username>/mynearcore:<version> sudo docker push <your username>/mynearcore:<version> sudo docker tag nearcore <your username>/mynearcore:latest sudo docker push <your username>/mynearcore:latest
Official image is published at