This Wiki topic’s goal is to serve as a working document, in order to provide an up-to-date tutorial for OH3 aimed at new users and novices. Everyone is welcome and encouraged to edit it, when we’re satisfied it will make its way to the official docs. You may reply for the specific purpose of improving the article are allowed, but please, this is NOT a support thread: if you’re stuck while reading this and are simply seeking support please open another thread. Thanks!
Once installed and started, launch openHAB’s user interface by navigating to http://localhost:8080 (if not running locally, replace localhost with the server’s address accordingly). If you installed from the Openhabian image, the default host name will work without needing to know the IP http://openhabianpi:8080
The following screen should will appear:
By default, the administration pages are restricted to logged in administrators.
Click on the shield icon in the lower-left corner in the sidebar:
If you don’t see it, click on the menu icon on the top-left corner to reveal the sidebar first.
Since there are no users yet, openHAB will ask you to define a login and password for the first user, which will automatically have the administrator role.
Currently the only way to add additional users or manage existing ones (including changing passwords and attributing roles) is with the Console.
Once you have successfully created the admin account, you will be taken back to the previous screen, except the Administration area will now be accessible in the sidebar:
If you need to sign out, or check what session are open with this account and terminate them, click on the account option which has replaced the “Unlock administration” shield:
Note that by default, using openHAB doesn’t require you to sign in, only administrative operations require a user with an administrator role to be logged in.
Click on Settings.
Click on Regional Settings under System Services.
Configure the local language, region and time zone. You can also specify the exact location (latitude, longitude, altitude) of your home, which some add-ons can use to preset their configuration - for instance the astro binding will use the location to determine the time of astrological events, like sunrise and sunset in your area.
If you’re not using the metric system, click “Show advanced” and change the measurement system.