Practical overview
When it fits
Use Neo Go when you need a Go-based Neo node or are building Go applications and smart-contract tooling for the Neo ecosystem.
Who it is for
- Operators setting up a Neo private, mainnet, or testnet node
- Go developers building applications or smart contracts for Neo
- Teams needing Neo RPC, command-line, or node monitoring and debugging components
Documented uses
- Run a Neo node connected to a private or public network.
- Build Go software that interacts with the Neo blockchain using the SDK.
- Compile and work with Neo smart contracts using the compiler, examples, and private-network workshop.
- Enable Prometheus or Pprof services for node monitoring or debugging.
Requirements & limits
The project is publicly available on GitHub under the MIT license. It can be obtained as a binary, Docker image, or source build.
- Node configuration supports private, mainnet, and testnet networks through flags or configuration files.
- The project describes compatibility with the latest C# node releases and notes that some extensions are experimental.
- Building from source requires a supported modern Go version and make; the smart-contract compiler also requires Go.
- Prometheus is enabled by default in the documented configuration, while Pprof is disabled by default.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Build Neo Go from source
Produce the Neo Go binary from a tagged source release.
Before you start
- A supported modern Go version
- make
- A tagged Neo Go release
Steps
Check out a tagged release rather than an arbitrary master-branch revision.
Run
makefrom the project source directory.Use the resulting binary at
bin/neo-go.
Expected outcome
A locally built Neo Go binary.
Guide limitations
- The smart-contract compiler requires a Go compiler to operate.
- On Windows, the README recommends installing make from the MinGW package.
Start a Neo node on a selected network
Start a node using a private, mainnet, or testnet configuration.
Before you start
- A Neo Go binary, such as the binary produced by a source build
- A network configuration; the project uses
./configby default
Steps
Choose a network using
--privnet,--mainnet, or--testnet, or select a configuration with--config-file.Run
./bin/neo-go nodewith the chosen network flag or configuration option.For a Windows node, configure the firewall to allow inbound traffic on the P2P port.
Expected outcome
The node starts with the selected network configuration.
Guide limitations
- Running a consensus or committee node is covered by separate consensus documentation.
- The README's example command without a network flag starts on the private network.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 11 October 2026
- Original website title
- nspcc-dev/neo-go · Official homepage title · retained in its source language

