This section contains instructions on how to use the migration tooling to export end devices from supported LoRaWAN Networks, that can later be imported in The Things Stack.
ttn-lw-migrate is a tool that can be used for migrating end devices and applications from supported LoRaWAN® networks (like ChirpStack) to The Things Stack, or between The Things Stack distributions. This section provides details on how to install, configure and use this tool.
This tool works in a way that it exports descriptions of end devices and applications to a JSON file, that can later be imported in The Things Stack.
Installation#
The migration tool can be installed using package managers or manually from binary files. We highly recommend installing or upgrading to ttn-lw-migrate version 0.5.0 or newer, because some features like session migration are not available for prior versions.
To install ttn-lw-migrate tool with brew:
brew install TheThingsNetwork/homebrew-lorawan-stack/ttn-lw-migrate
To upgrade ttn-lw-migrate tool if updates are available:
brew upgrade TheThingsNetwork/homebrew-lorawan-stack/ttn-lw-migrate
To install ttn-lw-migrate tool with snap:
sudo snap install ttn-lw-migrate
To upgrade ttn-lw-migrate tool if updates are available:
sudo snap refresh ttn-lw-migrate
Download the zipped archive with binary files for Windows from Github.
Extract the folder from ZIP archive and enter the folder. Double-click to run the ttn-lw-migrate.exe executable file.
After this, you will be notified that you can run ttn-lw-migrate from the command prompt.
Usage#
To use the ttn-lw-migrate tool after successful installation, use your terminal or command prompt to navigate to the folder where it is installed and run the commands from there. Run ttn-lw-migrate help to see all available commands and flags.
Currently available sources listed in the table below. For detailed migration instructions using these sources, check the linked sections.
| Option | Used for |
|---|---|
tts |
Migrating between The Things Stack distributions, tenants, and/or applications |
chirpstack |
Migrating devices from ChirpStack version 4 |
chirpstack (v3) |
Migrating devices from ChirpStack version 3 |
firefly |
Migrating devices from Digimondo’s Firefly |
wanesy |
Migrating devices from Kerlink’s Wanesy |
awsiot |
Migrating devices from AWS IoT |
ttnv2 |
(Discontinued ) Migrating from legacy V2 deployments |