Versions
- Support for Pocket version
RC-0.10.4
- This version will automatically update your pocket config files to be compatible with the new release, including updating seeds and setting
client_session_sync_allowance
to its default value of1
.
- POKT Snapshot updated to work with POKT new endpoint.
1. Shutdown NP:

2. Update command:
cd ~ && wget -O np https://builds.decentralizedauthority.com/node-pilot/v0.18.17/np && chmod +x ./np
3. Start Node Pilot as daemon:
./np start -d
4. Type in your Node Pilot password

1) ONLY UPDATE TO
v0.18.x
FROM v0.16.1
or newer.
2) Because of the changes to how Pocket nodes are run, this release is not backwards compatible for Pocket nodes. Once you have upgraded to this version of Node Pilot, you cannot go back to a previous version of Node Pilot.After successfully updating to v0.18.x it is recommended you create a new backup of your Node Pilot instance.
3) Please install the Docker Compose Plugin as detailed here.
- Updated Ethereum, Polygon, Avalanche, and Binance Smart Chain clients
1. Shutdown NP:

2. Update command:
cd ~ && wget -O np https://builds.decentralizedauthority.com/node-pilot/v0.18.14/np && chmod +x ./np
3. Start Node Pilot as daemon:
./np start -d
4. Type in your Node Pilot password

1) ONLY UPDATE TO
v0.18.x
FROM v0.16.1
or newer.
2) Because of the changes to how Pocket nodes are run, this release is not backwards compatible for Pocket nodes. Once you have upgraded to this version of Node Pilot, you cannot go back to a previous version of Node Pilot.After successfully updating to v0.18.x it is recommended you create a new backup of your Node Pilot instance.
3) Please install the Docker Compose Plugin as detailed here.
- Choose client option (supported with Ethereum and more chains to come)
- Import and export individual nodes from the UI.
- Status updates to "Session" when POKT Validators are in a session.
- New secrets management using Docker Secrets to remove
priv_val_key.json
from POKT config directories.
It is recommended that users create new backups of their Node Pilot instances after updating, as older backups include the
priv_val_key.json
file which can be used to extract private keys.
Backups created with v0.18.x and beyond do not store any priv_val_key.json
files as they are only stored in an in-memory filesystem when Node Pilot launches.Due to the use of Docker Secrets, starting Node Pilot now requires your password during the startup process.
There are 3 ways to input your Node Pilot password
- 1.Manual entry via stdin (RECOMMENDED as most secure. See Update Process below.)
- 2.
- 3.Environment variable (advanced users only)
- Expose
nginx.conf
for the node manager nginx server to~/.node-pilot/config/nginx/nginx.conf
so that advanced users can set custom config values.
- Updated logging to differentiate between Node Pilot processes. Daemon instance logs go to
daemon.log
, restarter instance logs go torestarter.log
, and Node Pilot logs go toserver.log
. - Fixed Polygon snapshots
- Fixed Harmony block counts
- Updated versions of many supported chains
Gnosis nodes will need to be deleted from Node Pilot and redeployed as the new version requires new clients. This will require a resync.
- Many Node Launcher updates
1. Shutdown NP:

2. Install Docker Compose
sudo apt-get update && sudo apt-get install docker-compose-plugin
3. Update command:
cd ~ && wget -O np https://builds.decentralizedauthority.com/node-pilot/v0.18.12/np && chmod +x ./np
4. Start Node Pilot as daemon:
./np start -d
5. Type in your Node Pilot password

MAJOR BREAKING CHANGES!
This update includes file structure changes and a SPECIAL UPDATE PROCESS. Please read the "IMPORTANT NODES" below
👇
- Ethereum 2.0 support (using the Prism client)
- Ethereum Goerli testnet support
- All Node Pilot functionality is exposed via a JSON-RPC server at port 34417 (temporary documentation can be found here: https://gist.github.com/rBurgett/22605a4880e6f6e1cda15e426d02b299)
- All key passwords are now encrypted
- Nodes now automatically restart if they unexpectedly shut down
- Node Pilot can shut down without shutting down nodes
- Rinkeby deprecation
- The Ethereum Rinkeby testnet has been deprecated by the Ethereum foundation (https://blog.ethereum.org/2022/06/21/testnet-deprecation). As result, we will no longer be supporting Rinkeby in Node Pilot. You can no longer create Rinkeby nodes and we would recommend you delete any existing Rinkeby nodes. If you want to test with an Ethereum testnet, Goerli is the official testnet for Ethereum and as such Node Pilot now supports it.
- Pocket nodes are now served via Node Launcher which allows for one-click updating like other Node Pilot supported chains
- Updated file structure to allow for more flexibility and chain implementations as well as significantly smaller backup files
- POKT Validators fully use Node Launcher's validator API, which will soon include support for Fuse, Harmony, and Ethereum 2.0 staking through the UI.
- All node peer ports are now exposed to the host machine
This is the biggest release in the history of Node Pilot. It includes many significant new features as well as countless bug fixes. Node Pilot now provides API access to all of its functionality. This can be access via the new JSON-RPC server at port 34417 as well as via the command line. This allows for large-scale scripting of all Node Pilot functionality. The API has been heavily tested in production over the last few months with enterprise deployments running hundreds of Pocket nodes completely headless. This release also includes support for the new standard validator API through Node Launcher which allows for creating validator nodes and staking on multiple blockchains, not just Pocket. In the near future, Node Pilot will allow you to create and stake Fuse, Harmony, and Ethereum 2.0 validators.
When you first run Node Pilot 0.16.0 you will be led through a number of prompts while it updates. Before you upgrade, you will want to save a backup of your config folder in case anything unexpected happens during the upgrade. It is important to understand that these are breaking updates. After the changes have been made, you cannot revert to a previous version of Node Pilot without replacing your config folder with a backed up version and possibly your data folder as well.
It is important that these breaking changes be understood before updating.
1. File structure updates
There are a number of file structure changes which were necessary in order to support the validator API as well as a number of newer chains and chain clients. For example, there is no longer a
nodes.json
file in ~/.node-pilot/config
. The Pocket Nodes which used to be in there now live in ~/.node-pilot/config/chains.json
. There are also many changes within ~/.node-pilot/config/nodes
. Fuse and Pocket for example both have updated config file structures. In pocket node folders you will no longer find a root directory. The directories which used to be under the root directory in the config folder are now in the chain data folder. The configs themselves have been moved around as well. The pocket keystore is now in the keys directory where it belongs, having previously been in the root folder which no longer exists. Chain data in ~/.node-pilot/chains
have also been updated as well, with some chains experiencing more changes than others.
2. Encrypted Passwords
All key passwords are now encrypted. They used to be in plain text in
nodes.json
but are now stored encrypted within a new file called ~/.node-pilot/config/passwords.json
. This provides significantly more security, but it also means that you will not be able to copy validator nodes between Node Pilot instances just by copying the data from within chains.json
. While we have always encouraged people to not touch the files within the .node-pilot
directory, we know that some people do go in there and make their own changes at their own risk so it was worth bringing up.
All passwords are encrypted with the user's master password, so keeping track of your master password is more important than ever. If you lose your master password, you will lose all access to your Node Pilot instance. You can no longer do old tricks like deleting users.json
and then creating a new user. If you do that, you will not be able to decrypt your passwords. So, it is absolutely essential that you keep track of your master password and that you keep backups of your config folder and all of your keys.
3. CLI Changes
There are now multipe options when shutting down Node Pilot.
./np stop
used to stop Node Pilot and all nodes. But, now it only stops Node Pilot itself while leaving the daemonized nodes running. If you want to do a full shutdown of Node Pilot from the command line, you must enter ./np stop --all
.
4. Moving pocket nodes between Node Pilot instances
With Node Pilot 0.16.0, because of the changes to passwords and nodes, there is currently no way to move pocket nodes between Node Pilot instances. You can no longer just copy the files from one instance to another. We are working on a native solution for importing/exporting from the UI as well as from the CLI and via the API, but that is not ready yet. So, for the moment your pocket nodes cannot be moved from the Node Pilot instance that they were created in to another Node Pilot instance.
SPECIAL UPDATE PROCESS
👇
1. Backup your Node Pilot instance:

NOTE: It may take several minutes for NP to zip your config folder. Just click backup and do not navigate away from the screen until the "Save As" prompt appears.
2. Shutdown NP:

3. Update command:
cd ~ && wget -O np https://builds.decentralizedauthority.com/node-pilot/v0.16.1/np && sudo chmod +x ./np
4. Start Node Pilot as daemon:
./np start -d
5. Confirm you understand that this update has file/folder structure changes

6. Confirm you have a backup of NP saved

7. Confirm you have space for NP to make another backup of your NP configs

8. Create a master password (this is the same password you use to log into the NP dashboard.)

9. ETHEREUM USERS need to click "UPDATE" to upgrade to ETH2 nodes

NOTE: Currently ETH2 nodes will only have a "RUNNING" status and will not show a "SYNCING" status. This will be patched in a later NP update.
10. Delete any Rinkeby nodes
- Pocked nodes updated to pocket-core RC v0.9.0
1. Shutdown NP:

2. Update command:
cd ~ && wget -O np https://builds.decentralizedauthority.com/node-pilot/v0.12.14/np && sudo chmod +x ./np
3. Start Node Pilot as daemon:
./np start -d
Starting from v0.12.0 Node Launcher now uses a
config
directory and a keys
directory for all chain nodes.IF YOUR NODE PILOT SETUP PRE-v.012.0 AND HAS SCRIPTS OR CUSTOMIZATIONS, PLEASE NOTE THIS POSSIBLY BREAKING CHANGE!
Node folders (ex:
~/.node-pilot/config/nodes/eth-000/
) now contain a config
folder and a keys
folder. This allows for more flexibility in the future, but it does break backwards compatibility with previous versions of Node Pilot. This means that once you upgrade to Node Pilot 0.12.1, you cannot revert back to an earlier version. For this reason, WE HIGHLY RECOMMEND SAVING A BACKUP OF YOUR NODE PILOT CONFIG DIRECTORY BEFORE UPGRADING!NOTE: Polygon, IoTeX, and OEC are still considered BETA features.
- Improved clean shutdown process to optimize for Polygon nodes
- New POKT Testnet seeds added for Testnet nodes
1. Shutdown NP:

2. Update command:
cd ~ && wget -O np https://builds.decentralizedauthority.com/node-pilot/v0.12.12/np && sudo chmod +x ./np
3. Start Node Pilot as daemon:
./np start -d
Starting from v0.12.0 Node Launcher now uses a
config
directory and a keys
directory for all chain nodes.IF YOUR NODE PILOT SETUP PRE-v.012.0 AND HAS SCRIPTS OR CUSTOMIZATIONS, PLEASE NOTE THIS POSSIBLY BREAKING CHANGE!
Node folders (ex:
~/.node-pilot/config/nodes/eth-000/
) now contain a config
folder and a keys
folder. This allows for more flexibility in the future, but it does break backwards compatibility with previous versions of Node Pilot. This means that once you upgrade to Node Pilot 0.12.1, you cannot revert back to an earlier version. For this reason, WE HIGHLY RECOMMEND SAVING A BACKUP OF YOUR NODE PILOT CONFIG DIRECTORY BEFORE UPGRADING!NOTE: Polygon, IoTeX, and OEC are still considered BETA features.
- Automatically fixes broken Let's Encrypt symbolic links
- IoTeX memory reporting bug fixed
- POKT nodes updated to v0.8.2
- IoTeX memory reporting bug fixed
- General updates and fixes
1. Shutdown NP:

2. Update command:
cd ~ && wget -O np https://builds.decentralizedauthority.com/node-pilot/v0.12.11/np && sudo chmod +x ./np
3. Start Node Pilot as daemon:
./np start -d
Starting from v0.12.0 Node Launcher now uses a
config
directory and a keys
directory for all chain nodes.IF YOUR NODE PILOT SETUP PRE-v.012.0 AND HAS SCRIPTS OR CUSTOMIZATIONS, PLEASE NOTE THIS POSSIBLY BREAKING CHANGE!
Node folders (ex:
~/.node-pilot/config/nodes/eth-000/
) now contain a config
folder and a keys
folder. This allows for more flexibility in the future, but it does break backwards compatibility with previous versions of Node Pilot. This means that once you upgrade to Node Pilot 0.12.1, you cannot revert back to an earlier version. For this reason, WE HIGHLY RECOMMEND SAVING A BACKUP OF YOUR NODE PILOT CONFIG DIRECTORY BEFORE UPGRADING!NOTE: Polygon, IoTeX, and OEC are still considered BETA features, but improvements to Polygon have been made in this release.
- Polygon Snapshots Fixed
- POKT nodes updated to v0.7.1.1
- Updated seed nodes for Fuse and Gnosis
- Updated NGNX to only whitelist
/v1
and/v1/client
routes when accesses from public DNS.
1. Shutdown NP:

2. Update command:
cd ~ && wget -O np https://builds.decentralizedauthority.com/node-pilot/v0.12.5/np && sudo chmod +x ./np
3. NEW NODE PILOT START COMMAND (since v0.9.4)
./np start -d
IF YOUR NODE PILOT SETUP HAS SCRIPTS OR CUSTOMIZATIONS, PLEASE NOTE THIS POSSIBLY BREAKING CHANGE!
Node folders (ex:
~/.node-pilot/config/nodes/eth-000/
) now contain a config
folder and a keys
folder. This allows for more flexibility in the future, but it does break backwards compatibility with previous versions of Node Pilot. This means that once you upgrade to Node Pilot 0.12.1, you cannot revert back to an earlier version. For this reason, WE HIGHLY RECOMMEND SAVING A BACKUP OF YOUR NODE PILOT CONFIG DIRECTORY BEFORE UPGRADING!NOTE: Polygon, IoTeX, and OEC should be considered BETA features as we have only been able to conduct limited testing.
- Polygon, IoTeX, and OEC are now available
- Added support for a NetData config file
- Ability to update TLS certs manually
- Adjust NetData storage parameters
- Updated NGINX cache paramerter
- Improved process for adding new chains to POKT nodes
- General updates and fixes
1. Shutdown NP:

2. Update command:
cd ~ && wget -O np https://builds.decentralizedauthority.com/node-pilot/v0.12.1/np && sudo chmod +x ./np
3. NEW NODE PILOT START COMMAND (since v0.9.4)
./np start -d
- Fixed "Pull Snapshot" issues for POKT bootstrapping
- Harmony and Ethereum nodes updated
- Optimized SSL Cert updating
- Limited NGINX logs to save on storage space
- GUI boots independent of POKT nodes
- Warnings users from running with a root user
- Fixed Harmony RelayChainID for new nodes
1. Shutdown NP:

2. Update command:
cd ~ && wget -O np https://builds.decentralizedauthority.com/node-pilot/v0.11.1/np && sudo chmod +x ./np
3. NEW NODE PILOT START COMMAND (since v0.9.4)
./np start -d
- Harmony explorer node integration
- NOTE: Currently Harmony nodes do not have an accessible way to pull the syncing status. For this reason, Harmony nodes will say "Running" even if they are syncing. To learn if you node is synced, check the latest block-height at the Harmony Explorer)
- Pull snapshot functionality for Pocket, Harmony, and Fuse
- Add/Remove Pocket Validator relay chains from the UI
- Allow Pocket Validators to server 0001 (Pocket Network)
- Stop node functionality
- Update stake functionality
- Clear node data directory functionality
- Delete node functionality
- Unjail functionality
- Users can set their own stake amount
- Increase Pocket RPC timeout
1. Shutdown NP:

2. Update command:
cd ~ && wget -O np https://builds.decentralizedauthority.com/node-pilot/v0.11.0/np && sudo chmod +x ./np
3. NEW NODE PILOT START COMMAND (since v0.9.4)
./np start -d
- Improved shutdown process
- Enables chain node updating without restarting
- Fixed update button glitch
1. Shutdown NP:

2. Update command:
cd ~ && wget -O np https://builds.decentralizedauthority.com/node-pilot/v0.9.5/np && sudo chmod +x ./np
3. NEW NODE PILOT START COMMAND (since v0.9.4)
./np start -d
- Daemon functionality (runs Node Pilot as an auto-restarting background application)
- 1-click updates for chain nodes
- Pocket updated to RC-v0.7.0.1
- Remove excessive pocket node info logs
1. Shutdown NP:

2. Update command:
cd ~ && wget -O np https://builds.decentralizedauthority.com/node-pilot/v0.9.4/np && sudo chmod +x ./np
3. NEW NODE PILOT START COMMAND
./np start -d
Once upgraded to v0.8.12, users can not return to past versions of Node Pilot.
- Show "Syncing" and "Running" states for both Pocket and Avalanche nodes
- Assign unique peer ports for all chains
- Expanding logging to catch errors during node startup
- Removed legacy codec flag from Pocket stake command
- Updated docker run command logging to correctly log all commands
- Updated nginx reverse proxy configs to decouple the UI nginx instance and nodes during boot
- Updated and clarified memory usage in node tables
- Updated xDAI load balancer name in configs to Pocket relay names
- Disabled Docker logging for node containers
- xDAI and AVAX nodes updated
1. Make sure you are running v0.7.11 before updating
2. Shutdown NP:

3. Update command:
cd ~ && wget -O np https://s3.amazonaws.com/files.decentralizedauthority.com/6e8cfa48-32e4-4059-a8c2-b530e4fafad1/np && sudo chmod +x ./np
4. Start Node Pilot
./np