# Edge Relay

## Design Overview

An Edge Relay is useful in environments which require the TilliT Edge Core logic to be located inside the OT network. Since the OT network does not have direct access to the cloud, an intermediary TilliT Edge Relay provides this access by forwarding local messages to the cloud and vice versa. If the connection to the IT networked server is severed, then the TilliT Edge Core can still read the local data sources (for example, and OPC-UA server) and will pool messages in a queue until a connection is re-established.

<figure><img src="/files/LsxaKqBVZ5FVLfAtiyLj" alt=""><figcaption></figcaption></figure>

## Video Guide

{% embed url="<https://youtu.be/NfWXDtj2I7A>" %}

## Install the Relay

1. Open TilliT and navigate to **Settings -> Edge**, then click the **create** button in the top right
2. Give a name for the Relay and ensure the Type selected is **Relay**. If you already know the **IP Address** of the server which will run the TilliT Edge Relay, then provide it in the field. Then click **Save**
3. You will be prompted to **Download** the certificates for the Relay Edge, save these files for later.

<figure><img src="/files/U6sEGJyRDSziqUF6uBPV" alt=""><figcaption></figcaption></figure>

4. Now, navigate to the Relay Edge you have just created and select **Download Edge** from the **Actions** menu

<figure><img src="/files/1pWMj7GeVoMRclyTMnqt" alt=""><figcaption></figcaption></figure>

5. Choose the appropriate download for your server. And install the TilliT Edge Agent as per normal

<figure><img src="/files/aHTNv2Fvxz762sF23hkm" alt=""><figcaption></figcaption></figure>

For how to install on **Windows** [See Here](/tillit/knowledge-base/setting-up-tillit/edge/edge/tillit-edge-agent-on-windows.md)

For how to install on **Linux/Docker** [See Here](/tillit/knowledge-base/setting-up-tillit/edge/edge/create-a-self-managed-docker.md)

After installation, check that the Online checkbox next to the edge is ticked and that you have entered the Relay Edge IP Address. You are ready to install the Core.

## Install the Core

1. Open TilliT and navigate to **Settings -> Edge**, then click the **create** button in the top right.
2. Give a name for the Core and ensure the Type selected is **Core**. Then select the **Relay** which this Core will be granted to have access to, this can only be done on creation of the Edge. Then click **Save** and **Download** the certificates like before.

<figure><img src="/files/VvnRenygFvzSYPUis0HC" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Upon creating a Core Edge with a Relay Edge, a deployment will be issued to the Relay Edge to configure the device with the correct permissions to allow connections only from the specified Core Edge. This may take up to 10 minutes to apply, during which the core device will not be able to connect to the relay edge.
{% endhint %}

3. Open the Edge Core you just created and open the **Download Edge** page from the Actions menu

<figure><img src="/files/8Zn3O4VLgunTiu3mTZtt" alt=""><figcaption></figcaption></figure>

3. As we want to use the Core in an offline environment, we cannot use any of the Agent installations. You must choose to download the **TilliT Edge Core Standalone for Windows**

<figure><img src="/files/ualGga8Ak2Uoh4r5vTQm" alt=""><figcaption></figcaption></figure>

3. Proceed to install the Windows Edge Core as seen [here](/tillit/knowledge-base/setting-up-tillit/edge/edge/tillit-edge-core-on-windows.md)
4. Confirm the installation has worked by observing a tick in the Online indicator next to the edge and an Online tick next to the Datasource connection if configured.

## Troubleshooting

When creating the Core. you may experience the following error<br>

<figure><img src="/files/q0xRNsXQ6wKyFmUhl6WP" alt=""><figcaption></figcaption></figure>

In this scenario, a generic message to check that the Relay device is online and running will be shown as it is a requirement for it to be before the Core can be created. If you are stuck getting the Relay device online, then our Support team will have more information to help.


---

# 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://help.tillit.cloud/tillit/knowledge-base/setting-up-tillit/edge/advanced-topics/edge-relay.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.