# Create an Edge

### Overview

A TilliT Edge device can be purchased directly from us, in which we will already have created the Edge for you. If you are bringing your own hardware such as a server to run the edge software, then this will guide you through the process of creating and installing the Edge software.

{% hint style="info" %}
The following naming convention is used to describe the different components that make up a TilliT Edge

**TilliT Edge Core** - The brains which connects to local datasources and sends actionable data to the cloud

**TilliT Edge Relay** - A deployable MQTT Broker to forward local messages to the cloud.

**TilliT Edge Agent** - An automatic updater for TilliT Edge software to ensure it has the most up to date version
{% endhint %}

### Navigation

{% hint style="info" %}
Navigation: ***Settings > Edge***
{% endhint %}

### Setting up a new Edge (not required for physical device)

On the table click ***Actions > Create***; you will be presented with a pop-up.

### **Fields**

| Name        | Description                                                                                                                                                                                                                                       |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name \*** | this is a name that you can call this Edge. Make it so that you can recognise where you will install it.                                                                                                                                          |
| Description | an optional text field for you to use to describe that Edge device.                                                                                                                                                                               |
| Type \*     | <p>Core - Our regular TilliT Edge software which connects to local datasources<br>Relay - A TilliT Edge which acts to forward a Local only Core install to the cloud<br>MQTT - A custom connector or Ignition Module which connects to TilliT</p> |

Click the ***Save*** button. You must then download the certificates which have been generated for your device.

<figure><img src="https://352909507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrNT40XJFAFlAhUX8CcQS%2Fuploads%2Fgit-blob-c63ecc42df7abaa9b91fb497db4856a37b42d69d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
To check that your edge is online and working, observe the tick box in the "Online" field. Your edge device will update it's connected status every minute.
{% endhint %}

### Publishing changes.

Take note that there is a **PUBLISH CONFIGURATION** button on the top right toolbar.

<figure><img src="https://s3.amazonaws.com/helpscout.net/docs/assets/60208fd212248b2c96d50eeb/images/639ffdcf014b016b03f07a69/file-wK3UeRvMtB.png" alt=""><figcaption></figcaption></figure>

You will need to click on this button every time you change a configuration in order for that change to be applied.

Once you click this button, TilliT will send the new configuration version to the Edge device, and use it in the next poll cycle.

### Install on Hardware Using an Installer

TilliT Edge can be installed in your preferred way. See below for some helpful guides on how to install for each environment

#### TilliT Edge Agent

For installing either a Core or Relay type of edge. We highly recommend using this setup as it is the most seamless way to integrate.

{% content-ref url="edge/tillit-edge-agent-on-windows" %}
[tillit-edge-agent-on-windows](https://help.tillit.cloud/tillit/knowledge-base/setting-up-tillit/edge/edge/tillit-edge-agent-on-windows)
{% endcontent-ref %}

{% content-ref url="edge/create-a-self-managed-docker" %}
[create-a-self-managed-docker](https://help.tillit.cloud/tillit/knowledge-base/setting-up-tillit/edge/edge/create-a-self-managed-docker)
{% endcontent-ref %}

#### TilliT Edge Core (Advanced)

Only use when it must be required. For example, when installing in combination with an TilliT Edge Relay

{% content-ref url="edge/tillit-edge-core-on-windows" %}
[tillit-edge-core-on-windows](https://help.tillit.cloud/tillit/knowledge-base/setting-up-tillit/edge/edge/tillit-edge-core-on-windows)
{% endcontent-ref %}

#### TilliT Ignition Module

Already have Ignition? Our ignition module is perfect for sound us live production states, and we also send back current order information plus more.

{% content-ref url="../../../tools/ignition-module" %}
[ignition-module](https://help.tillit.cloud/tillit/tools/ignition-module)
{% endcontent-ref %}

### <mark style="color:blue;">Digging Deeper</mark>

Setting up Edge requires a considerable amount of configuration, and we have a dedicated section in our help documentation to assist you with the process.