The openHAB Documentation Has Moved

The documentation has moved to and

Please use the link below to be redirected to the new version of this article, and update your bookmarks.

Basic UI

The Basic UI is a web interface based on Material Design Lite from Google.


  • Responsive layout suitable for various screen sizes
  • AJAX navigation
  • Live update


# Icons can be disabled
# Icons can be shown as PNG or SVG images
# Default: PNG

Accessing Sitemaps

The Basic UI has a default layout showing all things and their corresponding items. You may create your own sitemaps and access them through the basic UI in 2 ways.

  1. Set the default sitemap via the Paper UI via Configuration -> Services -> Basic UI -> Configure, and set the Default Sitemap name.

  2. Passing the “sitemap” parameter to the URL used to access the server.

Example: http://hostname:8080/basicui/app?sitemap=sitemapname


Screenshot 1 Screenshot 2