# Configuration

## ⚙️ General

No matter what type of device, each device created can be configured under its general configuration tab.

When navigating through the configuration of a device, the first item displayed is the summary of its general settings.

<figure><img src="https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2FIn01xUikVrQfxN98r6m4%2FCleanShot%202025-07-10%20at%2014.21.16%402x.png?alt=media&#x26;token=61dc1ec1-2c7b-415a-8fd5-46cf92c2dfcd" alt=""><figcaption></figcaption></figure>

### Basic Details

Inside of this section you will find the **basic details** of your device, like its name and the device location description. You can always go back and modify those. Please remember click "Save" at the end of the page.&#x20;

### Visual Appearance

You will also find some **visual appearance** configuration. You can assign an Icon, which will be shown inside of the Map widget, if there is no Marker selected ("None").&#x20;

<figure><img src="https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2FAB1OV3OqkHM2lwqXCIXA%2FCleanShot%202025-07-10%20at%2014.32.32%402x.png?alt=media&#x26;token=552aba3e-ebba-4b14-951a-291a86ef5584" alt=""><figcaption></figcaption></figure>

You can also upload an image, which will be shown next to the name of the device, at the top of the screen.&#x20;

<figure><img src="https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2FXLgpL9879ca4vF72sC4n%2FCleanShot%202025-07-10%20at%2014.27.09%402x.png?alt=media&#x26;token=36b4670a-e49b-4292-997f-0154bebc3de5" alt=""><figcaption></figcaption></figure>

### Organization & Tags

Here you can assign your own tags to your devices. These help you sort your devices better, as well as to configure map widgets and reports.&#x20;

To setup a tag, just type in the name of the tag on the "Add Tag" field. Click Enter and don't forget to Save the changes at the end!&#x20;

### Metadata

You can use metadata to add your own information to your devices, which does not necessarily have to be stored in a field of the database.

You can also use metadata in some widgets on the dashboard, e.g. to create an overview of measured values in a table and colorise this table based on metadata.

You first assign a Key name. Click "+Add" to add the metadata field. Now you can enter a value. Again, don't forget saving the changes at the end!

<figure><img src="https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2F0xnzPCBTSId07NiZPuuP%2FCleanShot%202025-07-10%20at%2014.36.27%402x.png?alt=media&#x26;token=fab26837-43e4-4eea-81c4-aa129b60a1f6" alt=""><figcaption></figcaption></figure>

### Device Management

In there you will find an Offline Notifications checkbox. When you click on that, you (and only you) will receive email notifications if the device goes offline. The [online timeout ](#online-timeout)defines when devices go offline (if they haven't sent an X amount of time).  Email gets sent to the email address you are logged in with.&#x20;

<figure><img src="https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2FuMzbCcFOO7YKTv3wyRL7%2FCleanShot%202025-07-10%20at%2014.40.44%402x.png?alt=media&#x26;token=b65232c3-683f-476a-b20c-43962a197cdc" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
This option enables sending offline-alerts for the currently logged in user (you). If you want other users to receive notifications as well - you must instruct them to enable this on their side / account as well.&#x20;
{% endhint %}

You will also find Device Claiming, which allows you to enable the [Pincode Claiming](https://docs.datacake.de/device/claiming) functionality. You can also allow multiple claims, if that is what you want. Add a claim code and click on save. Now you can add your device to other workspaces using the Serial Number and the Claim Code.&#x20;

<figure><img src="https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2FIyVhzV1JEWlEOJ4EJlhP%2FCleanShot%202025-07-10%20at%2014.40.24%402x.png?alt=media&#x26;token=d6fea357-0150-4d43-b72f-f5b5d72f1aad" alt=""><figcaption></figcaption></figure>

## 🛠️ Product & Hardware

### Product Configuration

You can now establish Product-wide configurations. Remember that [Products](https://docs.datacake.de/device/product) may contain several devices, so be mindful.

### **Icon**

You can select an Icon for all devices of a specific product (that will save you time, in case you want to have the same icon for all devices). &#x20;

### **Product Slug**

This gets created the first time your product gets created. It cannot be changed!

### Online Timeout

If no further measured values or other messages are transmitted from a device within the time specified here, the device is displayed as offline in the listing and in other places.

### LoRaWAN/API Configuration

The next section depends on the type of device you have added to the platform.&#x20;

Please visit our documentation about how to create a connection to your Network Server for LoRaWAN devices [here](https://docs.datacake.de/lorawan/lns/thethingsindustries#downlinks).

If you want to know more about the Serial Number for API devices, you will find it [here](https://docs.datacake.de/integrations/webhook#serial-number).&#x20;

## Payload Decoder

### LoRaWAN devices

<figure><img src="https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2FkdiAq5I8PBRC8mG4HusH%2FCleanShot%202023-03-17%20at%2013.55.21%402x.png?alt=media&#x26;token=57fa8be8-202d-4b88-9f32-4f3e67f104a9" alt=""><figcaption></figcaption></figure>

### API devices

You will find a detailed guide on how to decode your device's payloads in the next article:

{% content-ref url="../integrations/webhook" %}
[webhook](https://docs.datacake.de/integrations/webhook)
{% endcontent-ref %}

<figure><img src="https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2FxQzxm4zotfwOr4OPoCr2%2FCleanShot%202023-03-17%20at%2013.56.44%402x.png?alt=media&#x26;token=2d39d8f8-9c76-45ae-9fe0-829cd8533512" alt=""><figcaption></figcaption></figure>

You will be able to see the incoming messages on the right side button "Show logs".&#x20;

## MQTT Configuration

On API devices after Payload decoders you will see the MQTT configuration section. To learn more about it visit:

{% content-ref url="../api/internal-mqtt/mqtt" %}
[mqtt](https://docs.datacake.de/api/internal-mqtt/mqtt)
{% endcontent-ref %}

## 🗓️ Fields

The fields are the measured values of your devices, which get stored in our time-series database. Depending on your subscription plan, a certain number of fields can be created per device. This are also the so-called "datapoints". To learn more about fields visit:

{% content-ref url="database/fields" %}
[fields](https://docs.datacake.de/device/database/fields)
{% endcontent-ref %}

To learn more about datapoints and data retention times in our time-series database visit:

{% content-ref url="database/data-retention-and-datapoints" %}
[data-retention-and-datapoints](https://docs.datacake.de/device/database/data-retention-and-datapoints)
{% endcontent-ref %}

## Suggested Fields

If your devices are receiving data, which gets processed by the payload decoder, but there are still no fields defined in the database, they will appear under Suggested Fields. You can add them to the platform by pressing "Create field", or you can remove them.&#x20;

## Configuration Fields

Configuration Fields allow you to create static variables that exist as a product-wide default and can be overwritten per device. To read more about how to use them visit the next link:

{% content-ref url="database/configuration-fields" %}
[configuration-fields](https://docs.datacake.de/device/database/configuration-fields)
{% endcontent-ref %}

## ⛓Integrations

You will find all about our [internal MQTT broker](https://docs.datacake.de/api/internal-mqtt/mqtt) under Integrations.&#x20;

<figure><img src="https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2FjvKFUuYwUJOqDQ5oiodH%2FCleanShot%202025-07-10%20at%2014.51.36%402x.png?alt=media&#x26;token=9dab105b-37f0-4cb4-8de4-0f58f91916ac" alt=""><figcaption></figcaption></figure>

## ⚠️ Danger Zone

Lastly, you will find the Danger Zone. Be careful with those configurations, since they are critical.&#x20;

You can change the plan or subscription in which your devices are, as  as see how many datapoints they have consumed in the past 24 hours.

You can purge selected field's data in a specific time range.&#x20;

To completely delete your device from the platform, select Delete Device. But be mindful, as this is irreversible!

<figure><img src="https://2221155863-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LNA8_b8wmabHgJ0QXoJ%2Fuploads%2FJrKEQTx5BDQppx2ZQX1V%2FCleanShot%202025-07-10%20at%2014.53.31%402x.png?alt=media&#x26;token=2e630502-5dd1-490f-be6f-524d3dffe44c" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.datacake.de/device/configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.