openHAB

# Settings - Overview

settings-page.png

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

# Configuration

config-overview.png

  • Things
    Configure and add your IoT devices and services.
  • Model
    Configure the semantic, tree-like hierarchical model that structures Items and allows openHAB to automatically provide a UI.
  • Items
    Items manage the functional layer of openHAB fully hardware-independent.
  • Pages
    Manage custom user interfaces including Main UI pages and sitemaps.
  • Transformations
    Transformations convert a value or Item state into different value or state.
  • Persistence
    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.

# 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? to learn more about the different options.

  • Rules
    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
    Special rules determined to command some Items to a pre-defined state.
  • Scripts
    Special rules without triggers and with just one action determined to run code.
  • Schedule
    Provides an overview of rules with time-based triggers and the Schedule tag.

# 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

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.

# 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

To save the changes, click the Save button or hit Ctrl + S 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.

Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)