Export End Device Data

    Updated Edit on GitHub
    Copy page

    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

    Export Devices from The Things Stack

    This section explains how to configure the migration tool and use it to export end devices from The Things Stack, that can later be imported in other The Things Stack deployments. This is a base for migrating end devices between The Things Stack distributions.
    Read

    Export End Devices from ChirpStack v3

    This section contains instructions on how to configure migration tool and use it to export end devices from ChirpStack v3, that can later be imported in The Things Stack. This is a base for migrating end devices from ChirpStack to The Things Stack.
    Read
    New in v0.12.0

    Export End Devices from ChirpStack v4

    This section contains instructions on how to configure migration tool and use it to export end devices from ChirpStack v4, that can later be imported in The Things Stack. This is a base for migrating end devices from ChirpStack to The Things Stack.
    Read
    New in v0.11.0

    Export End Devices from Wanesy

    This section contains instructions on how to configure migration tool and use it to convert end device information exported from Kerlink’s Wanesy Management Center, into The Things Stack end device format.
    Read
    New in v0.10.0

    Export End Devices from Firefly

    This section contains instructions on how to configure migration tool and use it to export end devices from Firefly, that can later be imported in The Things Stack.
    Read
    New in v0.13.0

    Export End Devices from AWS IoT

    This section contains instructions on how to configure migration tool and use it to export end devices from AWS IoT, that can later be imported in The Things Stack.
    Read

    Troubleshooting

    Read