> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-iot-server/getting-started.md).

# First Steps

This section helps you get oriented: how the interface is organized and a simple walkthrough to get your first device online with live data on a dashboard. The hands-on walkthrough here uses the LoRaWAN path. Other protocol integrations do not always start in the same place. Each feature has its own dedicated section later in the documentation — this is just the quick path to getting started.

<figure><img src="/files/9mIkl0n9mTnEGhp6yR7k" alt="The Kilo IoT Server sidebar beside the Overview page with its device and gateway counts, notifications and news"><figcaption></figcaption></figure>

**Start here if you would rather not do it by hand.** [Let AI Set It Up for You](/kilo-iot-server/getting-started/let-ai-set-it-up.md) covers the two ways to have AI do the setup work — the assistant built into Kilo, or the AI client you already use connected over MCP — and what each one will and will not do on its own. For many people that is the shortest route to a working deployment; the manual walkthrough below is still here whenever you want to understand the mechanics.

## What's in this section

| Page                                                                                     | What you'll learn                                                                                                       |
| ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| [Let AI Set It Up for You](/kilo-iot-server/getting-started/let-ai-set-it-up.md)         | Have the built-in assistant or your own AI client register devices, write the automation and configure alarms with you  |
| [Navigating the Interface](/kilo-iot-server/getting-started/navigating-the-interface.md) | A walkthrough of every section of the dashboard — sidebar, user menu, overview page, themes, and language               |
| [Your First Deployment](/kilo-iot-server/getting-started/your-first-deployment.md)       | A LoRaWAN quickstart: register a gateway, set up an LNS connector, add a device, build a dashboard, and set up an alarm |

## Prerequisites

* A Kilo IoT account (cloud or on-premise)
* A modern web browser (Chrome, Firefox, Safari, Edge)

**Hardware is optional.** The [Emulator connector](/kilo-iot-server/connectors/emulator-connector.md) creates devices that generate their own telemetry from real device presets, so you can build and test an entire deployment — dashboards, rules, escalating alarms — before any hardware arrives, then switch those same devices to a real connector when it does and keep everything you built.

To follow the hands-on LoRaWAN guide with real equipment you will want a LoRaWAN gateway and at least one sensor with its Device EUI and AppKey. Without them, use the Emulator and the guide still works end to end.

## The LoRaWAN quick-start flow

The typical LoRaWAN path from zero to a working deployment follows these steps:

```
Create account → Deploy gateway → Set up connector → Register device → View telemetry → Build dashboard → Set up alarm
```

Not every Kilo deployment begins with a gateway. LoRaWAN does. Direct integrations can start at the connector and device-modeling steps instead.

Each step builds on the previous one. In the LoRaWAN journey, the gateway provides network coverage, the device sends data through that gateway, the dashboard visualizes the data, and alert rules monitor it for conditions that need your attention.

The [Your First Deployment](/kilo-iot-server/getting-started/your-first-deployment.md) guide walks through this entire sequence.

## After the basics

Once you have live data, integrate Kilo with your own systems through the [API](/kilo-iot-server/api.md) — REST for standard integrations, and gRPC for typed, service-to-service, and on-premise/industrial automation.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.kiloiot.io/kilo-iot-server/getting-started.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.