---
layout: documentation
title: Settings
---

# Settings - Overview

![settings-page.png](../images/settings-page.png)

<!-- START MAINUI SIDEBAR DOC - DO NOT REMOVE -->
The settings page provides access to all openHAB setup and server-related settings that are configurable from the UI.
Please note that this page is only accessible for users with the administrator role.

Some often used subpages can also be accessed directly via the menu sidebar.

![settings-menu](../images/settings-menu.png)

<!-- markdownlint-disable MD001 -->
### Configuration

![config-overview.png](../images/config-overview.png)

- [**Things**](things)<br>
  Configure and add your IoT devices and services.
- [**Model**](model)<br>
  Configure the semantic, tree-like hierarchical model that structures Items and allows openHAB to automatically provide a UI.
- [**Items**](items)<br>
  Items manage the functional layer of openHAB fully hardware-independent.
- [**Pages**](pages)<br>
  Manage custom user interfaces including Main UI pages and sitemaps.
- [**Transformations**](transformations)<br>
  Transformations convert a value or Item state into different value or state.
- [**Persistence**](persistence)<br>
  openHAB can store data over time; this is known as persistence.
  The data may be retrieved at a later time, for example to restore your system after startup, or to prepare graphs for display on a UI.

Next to the entity, the count of that entity is shown.
The Things count is not the number of configured Things, but the number of Things waiting in the [Inbox]({{base}}/tutorial/things_simple.html#accept-the-light-bulb-things).

### Automation

openHAB provides rules, scenes and scripts as well as a schedule overview to automate your home.
See [What's the Difference Between a Rule, Script, and Schedule?]({{base}}/tutorial/rules_introduction.html#what-s-the-difference-between-a-rule-script-and-schedule) to learn more about the different options.

- [**Rules**](rules)<br>
  Rules are essential for home automation:
  Each rule can be triggered, which invokes a script that performs any kinds of tasks, e.g. turn on lights by modifying your items, do mathematical calculations, start timers etc.
- [**Scenes**](scenes)<br>
  Special rules determined to command some Items to a pre-defined state.
- [**Scripts**](scripts)<br>
  Special rules without triggers and with just one action determined to run code.
- [**Schedule**](schedule)<br>
  Provides an overview of rules with time-based triggers and the `Schedule` tag.
<!-- END MAINUI SIDEBAR DOC - DO NOT REMOVE -->

### System Settings

This section lists openHAB's system settings, which e.g. includes regional, language, unit system and network settings.

### Add-on Settings

This section lists the installed add-ons and provides direct access to the add-on settings as well as the add-on log level:

![log-level.png](../images/log-level.png)

The standard log level is `INFO` but to track down an issue it might be necessary to increase the log-level upon request.
For more information see [Logging in openHAB]({{base}}/administration/logging.html).

### Dirty Handling

When you modify a configuration/setting, there are unsaved changes and the configuration page becomes "dirty".
There is an ● indicator shown if the current settings page is dirty:

![dirty-indicator.png](../images/dirty-indicator.png)

To save the changes, click the `Save` button or hit <kbd>Ctrl</kbd> + <kbd>S</kbd> on your keyboard.
If you attempt to leave the current configuration page and there are unsaved changes, a warning dialog will be shown to avoid losing your changes.