Skip to content

Node Releases

Updates to the Nano protocol are done through major node releases, occurring approximately every 1 to 4 months, and necessary patch releases in between. As changes are made to the protocol over time, newer node versions will stop peering with older versions. Details on which versions are actively peering, supported and being developed are included below.

Current Release

The following release is the latest and only release actively supported by the Nano Foundation. This release and the Active Releases below represent the only node versions that will participate on the main network. More details can be found on the Current Release Notes page.

Node Protocol Database Release Date Release Notes GitHub Links
21.2 18 18 2020-09-03 V21.2 Release - Milestone - Changelog
Known Issue V19+: macOS 'Too many open files'
  • Issue: The following error can be seen when attempting to run a full node on macOS using the built-in Qt wallet or other GUI-based wallets: "Exception while running wallet: open: Too many open files". This is due to macOS having a very low default file descriptor limit and V19.0 uses more of them after the move to TCP.

  • Solution: For now a workaround is needed to increase the limit. The method depends on the specific macOS version, but some people had success with the recipe in https://superuser.com/a/1171028.

Builds and Commands

OS Download link/command Verification
Universal Linux https://repo.nano.org/live/binaries/nano-node-V21.2-Linux.tar.bz2 SHA256 Checksum
Debian http://repo.nano.org/live/binaries/nano-node-V21.2-Linux.deb SHA256 Checksum
macOS https://repo.nano.org/live/binaries/nano-node-V21.2-Darwin.dmg SHA256 Checksum
Windows (exe) https://repo.nano.org/live/binaries/nano-node-V21.2-win64.exe SHA256 Checksum
Windows (zip) https://repo.nano.org/live/binaries/nano-node-V21.2-win64.zip SHA256 Checksum
Docker docker pull nanocurrency/nano:V21.2 or docker pull nanocurrency/nano:latest
See Pulling the Docker Image for more details.
RHEL/CentOS rpm sudo rpm -iUvh https://repo.nano.org/live/binaries/nanocurrency-21.2-21.el7.x86_64.rpm
This installs nano_node and nano_rpc to /usr/bin.
SHA256 Checksum

Next Planned Release

The following release is currently under development. Details about potential features to be included can be found on the Upcoming Features page.

Node Protocol Database Release Date Release Notes GitHub Links
22.0 TBD TBD TBD TBD Release - Milestone - Changelog

Setup for testing on beta network

If you are looking to test the latest version of the node ahead of release, check out the Beta Network page for more details about how to get setup. Testing specific features, integrations and anything else is highly encouraged during all stages of node development.


Active Releases

The following releases can still actively participate on the network by peering with other nodes of the same versions. Any nodes running versions earlier than these will no longer peer with the latest and fall out of sync with the network.

Node Protocol Database Release Date Release Notes GitHub Links
21.2 18 18 2020-09-03 V21.2 Release - Milestone - Changelog
Known Issue V19+: macOS 'Too many open files'
  • Issue: The following error can be seen when attempting to run a full node on macOS using the built-in Qt wallet or other GUI-based wallets: "Exception while running wallet: open: Too many open files". This is due to macOS having a very low default file descriptor limit and V19.0 uses more of them after the move to TCP.

  • Solution: For now a workaround is needed to increase the limit. The method depends on the specific macOS version, but some people had success with the recipe in https://superuser.com/a/1171028.


Node Protocol Database Release Date Release Notes GitHub Links
21.1 18 18 2020-07-14 V21.1 Release - Milestone - Changelog
Known Issue V19+: macOS 'Too many open files'
  • Issue: The following error can be seen when attempting to run a full node on macOS using the built-in Qt wallet or other GUI-based wallets: "Exception while running wallet: open: Too many open files". This is due to macOS having a very low default file descriptor limit and V19.0 uses more of them after the move to TCP.

  • Solution: For now a workaround is needed to increase the limit. The method depends on the specific macOS version, but some people had success with the recipe in https://superuser.com/a/1171028.

Known Issue Windows V21: Crash when using config node.logging.stable_log_filename

Setting node.logging.stable_log_filename configuration option to true results in a node crash on Windows in V21.0 and V21.1, after a node restart. This must be set to false.


Node Protocol Database Release Date Release Notes GitHub Links
21.0 18 18 2020-06-16 V21.0 Release - Milestone - Changelog
Known Issue V19+: macOS 'Too many open files'
  • Issue: The following error can be seen when attempting to run a full node on macOS using the built-in Qt wallet or other GUI-based wallets: "Exception while running wallet: open: Too many open files". This is due to macOS having a very low default file descriptor limit and V19.0 uses more of them after the move to TCP.

  • Solution: For now a workaround is needed to increase the limit. The method depends on the specific macOS version, but some people had success with the recipe in https://superuser.com/a/1171028.

Known Issue Linux V21: 'unable to find libboost'

If you are on Linux and unable to get V21.0 to start, unable to find libboost... https://github.com/nanocurrency/nano-node/releases/download/V21.0/nano-node-V21.0.1-Linux.tar.bz2 has been added to the release artifacts with the correct lib rpath. Please use this if you do not wish to move the lib folder into the bin folder after extraction.

Known Issue Windows V21: Crash when using config node.logging.stable_log_filename

Setting node.logging.stable_log_filename configuration option to true results in a node crash on Windows in V21.0 and V21.1, after a node restart. This must be set to false.


Inactive Releases

The following versions are no longer peered with by nodes running the active versions above and will not work properly communicate if run on the network. The details below are for historical purposes only.

Inactive Releases
Node Protocol Database Release Date Release Notes GitHub Links
20.0 17 15 2019-11-12 V20.0 Release - Milestone - Changelog
19.0 17 14 2019-07-11 V19.0 Release - Milestone - Changelog
18.0 16 13 2019-02-21 Release - Milestone - Changelog
17.1 15 2018-12-21 Release - Milestone - Changelog
17.0 15 2018-12-18 Release - Milestone - Changelog
16.3 14 2018-11-20 Release - Milestone - Changelog
16.2 14 2018-10-11 Release - Milestone - Changelog
16.1 14 2018-09-29 Release - Milestone - Changelog
16.0 14 2018-09-11 Release - Milestone - Changelog
15.2 13 2018-08-22 Release - Milestone - Changelog
15.1 13 2018-08-20 Release - Milestone - Changelog
15.0 13 2018-08-20 Release - Milestone - Changelog
14.2 11 2018-06-21 Release - Changelog
14.1 10 2018-06-11 Release - Changelog
14.0 10 2018-06-11 Release - Changelog
13.0 9 2018-05-10 Release - Changelog
12.1 8 2018-04-21 Release - Changelog
12.0 8 2018-04-18 Release - Changelog
11.2 7 2018-04-04 Release - Changelog
11.1 7 2018-03-29 Release - Changelog
11.0 7 2018-03-23 Release - Changelog
10.0 6 2018-02-15 Release - Changelog

Details for versions older than 10.0 can be found in tagged releases in Github.

Release Notes

For the latest release notes, see the Current Release Notes page. To reference release notes for older versions (V19.0, V20.0), see the Previous Release Notes page.