# Golioth

### Overview <a href="#overview" id="overview"></a>

The Qubitro and Golioth integration allows you to sync all devices and their data from Golioth Cloud to Qubitro using Golioth Pipelines—without writing any code.

Once your hardware is configured and sending data to Golioth, a corresponding device is automatically created in Qubitro, representing each device with its unique platform IDs.

Qubitro also decodes incoming data automatically, and transformation functions can be applied if modifications are needed before the data is stored.

### Prerequisites

* [x] Administrative access to both accounts.
* [x] A Qubitro account with an existing project.
* [x] A Golioth account with active devices sending data

### How It Works

Below is the diagram that shows how the integration works.

{% @mermaid/diagram content="graph LR;
A\[Device Publishes Data to Golioth] --> B{Device Exists in Qubitro?};

B -- No --> C\[Qubitro Creates Device];
B -- Yes --> D\[Use Existing Device];

C --> E\[Apply Built-in Decoder];
D --> E;

E --> F\[Store Data in Qubitro];

%% Style Adjustments
style A fill:#d9d9d9,stroke:#000,color:#000;
style B fill:#f2f2f2,stroke:#000,color:#000;
style E fill:#e0e0e0,stroke:#000,color:#000;" %}

{% hint style="warning" %}
If a [Transformation Function](https://docs.qubitro.com/platform/functions/transformation-function) is enabled, data will be processed before storage. The built-in decoder applies first, and then any defined transformation function modifies the data before it is stored in Qubitro.
{% endhint %}

### Configuring the Integration

{% stepper %}
{% step %}
**Create an Integration in Qubitro**

1. Log in to the **Qubitro Portal**.
2. Select a project from the list.
3. Click **New Source**.
4. Select **Golioth** from the available sources.

<figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2FfUxirleIoJFEWUrnzvo8%2FCleanShot%202025-05-15%20at%2021.41.15%402x.png?alt=media&#x26;token=e32d5c13-eb4f-4b40-9760-e39bb822270c" alt=""><figcaption></figcaption></figure>

This page displays the pipeline snippet for Qubitro configuration. Keep it open for the next step.
{% endstep %}

{% step %}

### Setup Up The Golioth Pipeline

1. Log in to **Golioth**.
2. Click **Pipelines** from the left menu and paste the code snippet&#x20;

<figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2F4sw5eqmWdoW4i4NgWXdJ%2FCleanShot%202025-05-15%20at%2021.42.56%402x.png?alt=media&#x26;token=7a3f968a-bb00-4d30-8053-00d73b340154" alt=""><figcaption></figcaption></figure>

3\. Click **Create** to save the configuration.
{% endstep %}

{% step %}
**Verify the Integration**

1. Return to Qubitro Portal
2. Clock **Go to Project** and then **Refresh** to check if the devices appear.

<figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2FZYDKyPxnQyMqmdX7t4wX%2FCleanShot%202025-05-12%20at%2017.29.47%402x.png?alt=media&#x26;token=88c1ebcc-9b5b-4737-96bf-227c7f11ec66" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Devices should have published at least one data point.
{% endhint %}

3. Open a device and navigate to the **Settings** tab to verify device credentials, or to the **Storage** tab to verify incoming data.

<figure><img src="https://3109056034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQfo4zX1x0hfOimS9E2u%2Fuploads%2Fqq3YuCjMvHsAVTepeIUn%2FCleanShot%202025-05-12%20at%2017.34.05%402x.png?alt=media&#x26;token=d93513f2-c48c-455c-a2d1-e868ccb8cb6d" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}
