Moving A Node Pilot Instance

Node Pilot is designed to be as portable as possible. This is important because hardware requirements may change frequently as chains update their node clients.

All settings and configurations are transferred over when following this guide.

NOTE: For these instructions, (A) represents the old instance, and (B) represents the new instance.

Prepare Machine(B)

1. Create new machine with the same username. Using a different username with break the migration.

2. Install Node Pilot on machine(B), but do not run Node Pilot(B) yet.

3. Create a new .node-pilot folder on machine(B) in the home directory

Via CLI:

mkdir ~/.node-pilot

Backup and transfer on Machine(A)

4. Save a Backup of Node Pilot(A) for extra protection.

Click "BACKUP" to download a backup ZIP of your config folder. If your backup includes Pocket nodes, the file could be many gigabytes which will take a few minutes before the download begins.

DO NOT NAVIGATE AWAY FROM THIS PAGE UNTIL THE FILE IS SAVED.

5. Shut down Node Pilot(A)

6. Go to your DNS service provider and point your Node Pilot domains to the public IP address of machine(B). YOU MUST USE THE SAME DOMAINS.

See Configure Node Pilot for the original DNS instructions

7. From machine(A), use this command to transfer your Node Pilot config folder to machine(B)

scp -r '/home/<USER(1)>/.node-pilot/config' <USER(2)>@<DOMAIN NAME>:/home/<USER(2)>/.node-pilot/

Example: scp -r '/home/amish/.node-pilot/config' [email protected]:/home/amishb/.node-pilot/

Launch on Machine(B)

8. Once the transfer is complete, configure any port forwarding if applicable on machine(B) (see Configure Node Pilot)

9. Run Node Pilot(B)

./np start -d

10. Go to your Node Pilot domain and log in to ensure everything is working.

11. Machine(A) is now ready to be wiped or deleted

Last updated

Was this helpful?