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.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.
Builds and Commands
| OS | Download link/command | Verification |
|---|---|---|
| Universal Linux | https://repo.nano.org/live/binaries/nano-node-V21.0.1-Linux.tar.bz2 | SHA256 Checksum |
| Debian | http://repo.nano.org/live/binaries/nano-node-V21.0.1-Linux.deb | SHA256 Checksum |
| macOS | https://repo.nano.org/live/binaries/nano-node-V21.0-Darwin.dmg | SHA256 Checksum |
| Windows (exe) | https://repo.nano.org/live/binaries/nano-node-V21.0-win64.exe | SHA256 Checksum |
| Windows (zip) | https://repo.nano.org/live/binaries/nano-node-V21.0-win64.zip | SHA256 Checksum |
| Docker | docker pull nanocurrency/nano:V21.0 or docker pull nanocurrency/nano:latestSee Pulling the Docker Image for more details. |
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.
V19 and V20 will be depeered with epoch v2 distribution
Although V19 and V20 are currently listed as active releases, once epoch v2 distribution begins, all V21 nodes will begin depeering them and the only active version will be V21. All nodes will need to upgrade to V21 to continue participating on the network.
| 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.
| Node | Protocol | Database | Release Date | Release Notes | GitHub Links |
|---|---|---|---|---|---|
| 20.0 | 17 | 15 | 2019-11-12 | V20.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 V20: Peers stake reporting inaccurate (Windows only)
-
Issue: For Windows builds only, when calling confirmation_quorum RPC the
peers_stake_totalamount returned may be inaccurate, returning a range from the correct full peer stake amount down to 0. -
Solution: A solution to the issue has been found and as this is a reporting issue only, the fix will be included in the next released version. For those manually building the node, patching the fix pull request onto the V20.0 tag can resolve the issue now. Or alternatively, building on the V20.0 tag with
RelWithDebInfooption, see Build Instructions for Windows.
| Node | Protocol | Database | Release Date | Release Notes | GitHub Links |
|---|---|---|---|---|---|
| 19.0 | 17 | 14 | 2019-07-11 | V19.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.
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 |
|---|---|---|---|---|---|
| 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.