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.

brew install TheThingsNetwork/homebrew-lorawan-stack/ttn-lw-migrate

brew upgrade TheThingsNetwork/homebrew-lorawan-stack/ttn-lw-migrate

sudo snap install ttn-lw-migrate

sudo snap refresh ttn-lw-migrate

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.

To list available sources that you can migrate your end devices and applications from:

ttn-lw-migrate sources

Currently, there are three available sources listed in the table below. For detailed migration instructions using these three sources, check the linked sections.

The tts source can be used for migrating devices between applications in the same The Things Stack tenant, migrating between different tenants, or migrating between different The Things Stack deployments.