# Get started with Logable (https://logable.app/docs/guides/getting-started)

Create your organization, connect your first device, and put it on a dashboard. About fifteen minutes from start to finish.



Logable watches your equipment and tells you before something goes wrong. This guide takes you from a new account to a live dashboard.

You need three things in order: an organization, a device, and a dashboard.

## Create your organization [#create-your-organization]

Sign up at [logable.app](https://logable.app). Logable or your partner sets your organization up and invites you into it.

An organization holds your devices, your dashboards and your team. If you run more than one site, switch between them from the header.

> **Roles**

An organization has four roles: viewer, member, admin and owner. A viewer reads dashboards, alerts and devices. A viewer cannot change a device or see a device token. Invite colleagues once you have your first dashboard, so they land on something worth reading.

## Add your first device [#add-your-first-device]

A device in Logable is one piece of equipment that reports readings. A silo, a conveyor, a weigh bin.

1. Open **Devices** and select **Add Device**.
2. Pick the **Device Type** that matches the equipment. The type decides which field names the device may send. See [Device types](/docs/reference/device-types) if you are not sure which to pick.
3. Give the device a name your team will recognise on a phone at night. "Raw Meal Silo" is better than "Silo 1".
4. Fill in the configuration the type asks for. A silo needs a capacity and a weight unit. Configuration is not sent with a reading. It tells Logable how to read the values.
5. Select **Create Device**.

Logable shows the **device token** once, on the screen after you create the device. Copy it now and store it where you keep credentials. The token is the device's password. Anyone holding it can send readings as that device.

<Figure src="/docs/captures/first-device.webp" alt="The Devices page in Logable, showing one device named Raw Meal Silo with an online status" width="1400" height="743" sizes="(min-width: 1280px) 860px, (min-width: 640px) 90vw, 100vw" caption="The Devices page after adding one device." />

> **If you lose the token**

You cannot read a token again after that screen. Open the device's **Connection** tab and select **Regenerate Token**. The old token keeps working for 24 hours, so a device in the field does not drop off while you swap it.

## Send your first reading [#send-your-first-reading]

Nothing appears on a dashboard until the device sends a value.

HTTP and MQTT both carry readings. Both accept the same body and both use the device token.

* [Send readings over HTTP](/docs/integrate/rest-api). One POST per reading. The fastest way to test from a laptop.
* [Publish readings over MQTT](/docs/integrate/mqtt). Suited to gateways and constrained hardware.

A PLC or a Modbus device reaches Logable through a gateway. The gateway reads the equipment and republishes each reading on the device's own topic, using the same contract every other device uses.

Open the device's **Connection** tab for a ready code sample with this device's real id and token filled in.

## Put the device on a dashboard [#put-the-device-on-a-dashboard]

A dashboard is a screen of widgets. A widget shows one device, or one metric, in one shape.

1. Open **Dashboard** and select **Create dashboard**. Logable opens a new dashboard in edit mode, named after the date and time.
2. Rename it in the title field for what someone watches, not for the equipment. "Night shift" reads better than "Silos".
3. In the **Widget Library** sidebar, pick a widget and a size to add it to the dashboard.
4. Select **Configure** on the widget to choose the device and the metric. Each device type supports a different set of widgets. A silo has a silo visual; every type also supports charts, a gauge, a stat and a table.
5. Select **Save Configuration**. Drag the widget to size it, then select **Save**.

<Figure src="/docs/captures/first-dashboard.webp" alt="A Logable dashboard with a silo level widget and a line chart, both showing live values" width="1400" height="743" sizes="(min-width: 1280px) 860px, (min-width: 640px) 90vw, 100vw" caption="One device, two widgets, live values." />

The dashboard updates as readings arrive. You do not need to refresh it.

## What to do next [#what-to-do-next]

Set an alert so Logable tells you before a limit is crossed, instead of you watching a screen. Open the device's **Triggers** tab and start from a ready-made preset for that device type.

* [Send readings over HTTP](/docs/integrate/rest-api)
* [Publish readings over MQTT](/docs/integrate/mqtt)
* [Device types](/docs/reference/device-types)