This section explains how to migrate your devices between The Things Stack distributions.
There are multiple methods that you can use to migrate your devices from source The Things Stack distribution to target The Things Stack distribution, depending on if you want to migrate them with or without their existing session, and how many devices you wish to migrate. These methods include using the migration tool, The Things Stack Console or The Things Stack CLI.
Note:
We highly recommend using the migration tool and migrating devices without persisting their active session.Keep reading to learn how to migrate your devices using all of the above mentioned methods. As an example, we demonstrate migrating from The Things Stack Sandbox to The Things Stack Cloud.
Prerequisites
- A user account on source The Things Stack with an application containing registered devices.
- A user account on target The Things Stack.
Note:
We recommend testing migration on a single end device or a small batch of end devices in order to make sure the migration process goes as expected.Add Application in target The Things Stack
You first need to add a new application in target The Things Stack. See Adding Applications for detailed instructions.
When adding an application in target The Things Stack, the Application ID does not have to be the same as the one in source The Things Stack.
Add Payload Formatters and Integrations in target The Things Stack
After creating an application in target The Things Stack, you need to add the associated elements like application-level payload formatters and integrations. Commonly, you can copy-paste payload formatters from source The Things Stack to target The Things Stack, and you can recreate all integrations on target The Things Stack in the same way as you created them on source The Things Stack.
See Payload Formatters and Integrations for more info.
Migrate End Devices and Gateways
Instructions for migrating your devices will differ depending on if you are using OTAA or ABP devices, and if you want to preserve their active session or not. Migrating your gateway will be needed in some cases. Choose your scenario and find the instructions in the following subsections.
If you experience issues with devices or gateways that you’ve migrated, check out the Troubleshooting Devices and Troubleshooting Gateways sections.