Devices are managed under applications. An application can contain an unlimited number of devices, but it can be helpful to sort devices in to applications by function or geographical area, to make the integrations and live data views more useful.

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 **+ Add end device** to reach the end device registration page.

{{< figure src="proxy.php?url=https%3A%2F%2Fgithub.com%2F%3Cspan+class%3D"x x-first x-last">application-overview.png" alt="Application overview" >}}

The [LoRaWAN device repository](https://github.com/TheThingsNetwork/lorawan-devices) contains device profiles, LoRaWAN information, codecs, and more, for many LoRaWAN devices. Using the device repository to add devices in {{% tts %}} automatically uses the correct LoRaWAN version and regional parameters version, which means less information for you to find!

To use the device repository, make sure the **From the LoRaWAN Device Repository** button is selected. Then, select the **Brand**, **Model**, **Hardware Version**, **Software Version**, and **Region** for your device.

{{< note "If your device is not in the device repository, see [Manually Create End Device](#manually-create-end-device) below." />}}

{{< figure src="proxy.php?url=https%3A%2F%2Fgithub.com%2Fdevice-%3Cspan+class%3D"x x-first x-last">repo.png" alt="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.

Enter a **JoinEUI/AppEUI** if provided by your manufacturer. If your device is programmable, you may use all 0's, and then program the same JoinEUI/AppEUI in the device.

If your manufacturer provides an **AppKey**, enter it. Otherwise, use the generate button to create one, and program it in to your device.

Finally, give your device a unique **End device ID**, and click the **Register end device** button to create the end device.

{{< note >}}

See [ID and EUI constraints]({{< ref "reference/id-eui-constraints" >}}) for guidelines about choosing a unique ID.

{{</ note >}}

{{< figure src="device-repo-settings.png" alt="Device information" >}}

The device is now activated, and will appear as connected in {{% tts %}} once it sends an uplink.

If your device is not in the device repository, you may manually register it.

Make sure the **Manually** button is selected.

{{< figure src="register-manually.png" alt="Register manually" >}}

Choose the **Activation Mode**.

Select the device **LoRaWAN version**.

If using Over-the-Air-Activation (OTAA) and an External Join Server, tick the **External Join Server** button.

The **Network Server**, **Application Server**, and **Join Server** addresses should correctly point to the address of your {{% tts %}} deployment.

Click the **Start** button to proceed to the Basic Settings page.

{{< figure src="manual-settings.png" alt="Register manually" >}}

{{< note >}}

This guide covers adding a device using [OTAA]({{< ref "reference/glossary#over-the-air-activation" >}}) (the most secure and preferred activation method) and [LoRaWAN version]({{< ref "reference/glossary#over-the-air-activation" >}}) MAC V1.0.2 (the most common LoRaWAN version, although newer version are better and more secure). Names and keys may vary slightly for other versions.

{{</ note >}}

Give your device a unique **End device ID**.

{{< note >}}

See [ID and EUI constraints]({{< ref "reference/id-eui-constraints" >}}) for guidelines about choosing a unique ID.

{{</ note >}}

Enter a **JoinEUI/AppEUI** if provided by your manufacturer. If your device is programmable, you may use all 0's, and then program the same JoinEUI/AppEUI in the device.

Enter your **DevEUI**.

**Name** and **Description** are optional fields to help you identify your device.

Click **Network Layer Settings** to proceed to the next page.

{{< figure src="basic-settings.png" alt="Basic settings" >}}

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

Choose the **Regional Parameters version** provided by the manufacturer of your device. This should be specified in the data sheet as Regional Parameters or PHY version.

If your device supports **Class B** or **Class C** features, you may enable them using the checkboxes.

There are also advanced settings to configure **Frame counter width** and **RX2 settings**, but these should not be necessary for most devices.

Click the **Join settings** button to proceed to the next page.

If your manufacturer provides an **AppKey**, enter it. Otherwise, use the generate button to create one, and program it in to your device.

Finally, click **Add end device** to register the end device.

{{< figure src="proxy.php?url=https%3A%2F%2Fgithub.com%2F%3Cspan+class%3D"x x-first x-last">join-settings.png" alt="Join settings" >}}