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, there are three available sources listed in the table below. For detailed migration instructions using these three 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 Firefly |
ttnv2 |
(Discontinued ) Migrating from legacy V2 deployments |