Skip to content
The Things Stack documentation home
Getting Started Concepts Cloud Enterprise Integrations API Hardware
Getting Started Concepts
Cloud Enterprise
Integrations API Hardware
Get The Things Stack

    Recent searches

      Popular pages

      • Getting Started
      • Adding Gateways
      • Adding Devices
      • Payload Formatters
      • Webhooks
      • Authentication

      No results for “”.

      • Check the spelling, or try fewer or more general words.
      • Ask the community on The Things Network Forum
      • Contact support
      ↑↓ to navigate ↵ to open Esc to close

      Hardware

      • Overview
      • Devices
        • Adding Devices
          • Manually adding devices
          • Adding devices in bulk
          • Adding devices with ATECC608 Secure Elements
        • Configuring Devices
        • Concepts
        • Models
        • Troubleshooting Devices
      • Gateways
      • Works with The Things Stack

      Adding Devices

      Updated 20 January 2025 Edit on GitHub
      Copy page
      • View as MarkdownThis page as plain text
      • Open in ChatGPTAsk questions about this page
      • Open in ClaudeAsk questions about this page

      This section contains instructions for adding LoRaWAN® devices in The Things Stack.

      End devices in The Things Stack are managed under Applications. An application is a logical collection of devices that can be used to collect devices by function or geographical area. Before proceeding with this guide, create an application first.

      This guide assumes that your device is in the LoRaWAN® Device Repository and that you’re using the Console. If your device is not in the LoRaWAN® Device Repository or if you want to use The Things Stack CLI, see Manually adding devices .

      To create a device, first open the application you wish to add the device in. Go to End devices in the left menu and click on +Register end device to reach the end device registration page.

      Application overview

      You will be presented with options to easily onboard your device using its QR code (if you have it), and to register your end device from the LoRaWAN® Device Repository or manually.

      Options to register devices
      • With QR Code
      • Without QR Code

      Onboarding devices using QR codes

      If your device has a TR005 LoRaWAN® Device Identification QR Code, adding a device is a simple process. Note not all QR codes on the physical device are scannable. Only TR005 LoRaWAN® Device Identification QR Codes, are supported for this method.

      Click the Scan end device QR code button and allow The Things Stack to use your camera. Now just bring your device’s QR code closer to your camera. A window with data found from the QR code will appear, containing your device’s Claim authentication code, JoinEUI, DevEUI and Brand.

      Found QR data

      If the data is correct, click Apply.

      Now proceed to choose the Input Method under the End device type section below.

      Choose the Select the end device in the LoRaWAN Device Repository input method. Then, select the End device brand, Model, Hardware Version, Software Version, and Profile (Region) for your device.

      Creating a new device with the Device Repository

      Choose a Frequency plan appropriate for your region. Your device and gateway must use the same frequency plan to communicate.

      Choosing a frequency plan

      Onboarding devices without QR codes

      If your device doesn’t have a standard TR005 LoRaWAN® Device Identification QR Code, or has a vendor specific QR code, then the device identification and keys have to be entered manually.

      First choose the Select the end device in the LoRaWAN Device Repository input method. Then, select the End device brand, Model, Hardware Version, Software Version, and Profile (Region) for your device.

      Creating a new device with the Device Repository

      Choose a Frequency plan appropriate for your region. Your device and gateway must use the same frequency plan to communicate. This example uses Europe 863-870 MHz (SF9 for RX2 - recommended).

      Choosing a frequency plan

      Enter a JoinEUI/AppEUI if provided by your manufacturer and click Confirm. If it is not provided by the manufacturer and your device is programmable, you can generate a random one in accordance with the test ranges defined by the IEEE 802 standards or use all zeros, just make sure to program the same value into your device.

      Set the Join EUI

      Now enter your DevEUI. This should be provided by your manufacturer for commercial devices. If your device is programmable, you may generate an EUI using the Generate button, and program it in your device.

      For LoRaWAN version 1.0.x devices, you will see an AppKey field, and for LoRaWAN version 1.1.x devices you will also see a NwkKey field. If these keys are provided by your manufacturer, enter them. Otherwise, use the Generate button to create them, and program them into your device.

      Set the Device EUI and Device Keys

      Finally, enter an End device ID. Advisable is doing it in the format eui-{Device EUI}. You can edit this field and give the device a unique identifier. See ID and EUI constraints for guidelines about choosing a unique ID.

      Now verify that all the fields are filled and click the Register end device button to create the end device.

      The device is now registered, and will appear as connected in The Things Stack once it sends an uplink.

      Manually adding devices

      If your devices are not yet part of the LoRaWAN® Device Repository or you want to set advanced fields, you can add devices manually in The Things Stack.
      Read

      Adding devices in bulk

      Instead of adding devices one by one, The Things Stack supports multiple methods of adding multiple end devices at once. Adding multiple devices is also referred to as importing devices.
      Read

      Adding devices with ATECC608 Secure Elements

      The Things Industries and Microchip developed a security solution for LoRaWAN® that enables secure key provisioning and secure cryptographic operations using secure elements.
      Read
      ← Devices Manually adding devices →

      On this page

      • Onboarding devices using QR codes
      • Onboarding devices without QR codes

      Sections

      Getting Started

      Concepts

      Cloud

      Enterprise

      Integrations

      API

      Hardware

      Sitemap

      View our Sitemap

      Contributing

      GitHub

      About Us

      The Things Industries

      Privacy Policy

      Cookie settings

      Cookie Settings

      We use cookies to enhance your experience, analyze site traffic and deliver personalized content. Read our Privacy Policy.

      Cookie categories