> 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-robot-configuration/robot-settings.md).

# Robot settings

Configure global Robot settings, onboarding details, and add-on database options.

## Global Settings

When you first open the Unwaste EMS after installing the Home Assistant add-on, an **onboarding wizard** collects basic settings for your **Unwaste Robot**.

You can change most of these later under **Settings**.

Typical global settings include:

* **Robot name** — display name in the interface
* **Description** — optional free text
* **Location** — latitude and longitude (used for weather and solar forecasts)
* **Timezone** — local time zone for schedules and tariffs
* **Country** — used when selecting tariffs
* **Currency** — how prices and savings are displayed
* **Language** — interface language
* **Include VAT** — whether prices include value-added tax

***

## Connection Location

The **connection** form also has latitude and longitude fields.

In most installations these match the global robot location. They define the reference point for forecasts tied to that grid connection.

***

## After Onboarding

Once onboarding is complete:

1. Open **Design mode** to build your installation graph.
2. Configure the **connection** (tariffs, forecasts, optional Surplus mode).
3. Set up circuits, production, storage, and devices as described in the Configuration section.

See [Initial configuration](https://docs.unwaste.energy/en/unwaste-for-home-assistant/initial-configuration.md) for the first-run workflow.

***

## Home Assistant Add-on Options

Outside the Unwaste web interface, the add-on has optional settings in Home Assistant:

* **Use external database** — when enabled, connect to an external PostgreSQL/TimescaleDB instead of the built-in database
* **Server address, port, user, password, database name, SSL** — connection details for the external database (only when external database is enabled)

When **Use external database** is off, leave the database fields empty.

See [Local installation](https://docs.unwaste.energy/en/unwaste-for-home-assistant/local-installation.md) for add-on installation steps.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.unwaste.energy/en/unwaste-robot-configuration/robot-settings.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
