> For the complete documentation index, see [llms.txt](https://docs.unwaste.energy/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.unwaste.energy/en/unwaste-for-home-assistant/initial-configuration.md).

# Initial configuration

Complete the first-run setup for your Unwaste Robot and electrical installation.

## Initial configuration

## First Run

After installing and starting the Unwaste Home Assistant application (add-on), open it from the sidebar.

The first time you open Unwaste EMS, an **onboarding wizard** guides you through basic setup.

***

### Onboarding

You will be asked for:

* **Robot name** and optional description
* **Location** (latitude and longitude)
* **Timezone**, **country**, and **currency**
* **Language** and display preferences (for example whether prices include VAT)

These settings are described in [Robot settings](/en/unwaste-robot-configuration/robot-settings.md).

Accept the terms of use to continue.

***

### After Onboarding

Once onboarding is complete:

1. You enter **Design mode** automatically (or select **Design** from the top navigation).
2. Add your first **connection** and configure tariffs and forecasts. See [Connection](/en/unwaste-robot-configuration/connection.md).
3. Open the **installation graph** for that connection. The **main circuit** is created automatically — configure energy import (and return, if you have PV). See [Circuit](/en/unwaste-robot-configuration/circuit.md).
4. Add production, storage, and devices as needed. See [Designing your electrical installation](/en/unwaste-robot-configuration/designing-your-electrical-installation.md).

Before adding elements in Unwaste, ensure sensors and integrations exist in Home Assistant. See [Connecting devices](/en/unwaste-for-home-assistant/connecting-devices.md).

***

### Starting the Robot

Configuration changes are made while the robot is **STOPPED**.

When your installation graph and readings are configured:

1. Review configuration using **reload and validate** if available.
2. **Start** the Unwaste Robot from the system state control.
3. Use the **Dashboard** and operational views to verify data collection.

See [System Operation](/en/unwaste-robot-operation/system-operation.md).


---

# 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.unwaste.energy/en/unwaste-for-home-assistant/initial-configuration.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.