Building From Source

In this brief walk-through we will show you how to build the NEO•ONE Node from source code.

This can be useful for local debugging and if you would like to make your own contribution to the node repository.



Once you have cloned the NEO•ONE repository (or preferably your own fork of the repository) you can run the following to build the node entry point

cd neo-one
rush install
rush build -t @neo-one/node-bin
cd  ./packages/neo-one-node-bin/bin

rush build -t @neo-one/node-bin will build a bin for the node as well as the @neo-one packages that it depends on. For this tutorial we will cd into the entry point’s build directory to save time. Running the new node then is as simple as

node neo-one-node


Configuration Reference

When running the node locally it is quite easy to apply a configuration file compared to docker since we don’t have to mount it to a container. An example configuration for syncing the node

## path/to/config.json
  "node": {
    "rpcURLs": {

can be run using

node neo-one-node --config /path/to/config.json

individual options can also be layered on top of our configuration

node neo-one-node --config /path/to/config.json --environment.logger.level=trace

You can also add a .neo-onerc configuration file anywhere in the app directory (recommended at the root of the repo directory) to apply your configuration by default. See rc for more informatio on how NEO•ONE will find and apply the node configuration with an rc file.

Edit this page
  • Local Docker Development
  • Kubernetes
  • Docker Compose
  • Building From Source
  • Heroku Deployment
  • Configuration Reference
Previous Article
Docker Compose
Next Article
Heroku Deployment
InstallationMain ConceptsAdvanced GuidesAPI ReferenceContributing
GitHubStack OverflowDiscord ChatTwitterYouTube