Migrating a Darknode to another Cloud Provider

How to migrate a Darknode to another Cloud provider without having to deregister your node

Migrating a Darknode to a different cloud provider, like switching over from AWS to Digital Ocean, can be achieved without having to deregister your node first.

You will need to follow these steps:

1. Make sure your CLI is at least version v3.1.3. You can check your CLI version by running darknode version in your terminal.

If your CLI is not at version 3.1.3 or higher, you will need to run this command: curl https://www.github.com/renproject/darknode-cli/releases/latest/download/update.sh -sSfL | sh

2. Make sure your have the CLI folder of the Darknode you want to migrate. Quickest way to verify this is running: darknode list

If your Darknode is listed, you are good to go.

3. Use the darknode up command as if you are going to deploy a new Darknode, but use this extra --config parameter so the Darknode that is created is a copy of your previous.

Make sure to give this node a new name.

If you are setting up the Darknode on Digital Ocean:

darknode up --name NEW-DARKNODE-NAME --do --do-token DO_TOKEN --config CONFIG_FILE_PATH

If you are setting up the Darknode on AWS:

darknode up --name NEW-DARKNODE-NAME --aws --aws-access-key YOUR-AWS-ACCESS-KEY --aws-secret-key YOUR-AWS-SECRET-KEY --config CONFIG_FILE_PATH

4. You should now be redirected to the Command Center page at the end of the deployment, and it should show the status of the new Darknode. If you can see that the migration is successful.

5. You can now safely destroy the old Darknode. Currently you have to do this manually by destroying your VPS through the dashboard on your cloud service provider. You can also safely remove the old darknode folder on your computer.

All done!