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:latestSee 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.rpmThis 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.