This page is part of archived documentation for openHAB 3.3. Go to the current stable version
# First Steps
The following instructions will guide you through the initial steps after first installing openHAB.
# Create the Admin User
Once openHAB is installed and started, launch the user interface by navigating to
http://localhost:8080 (if not running locally, replace localhost with the server's address or hostname accordingly).
If you installed from the openHABian image, you can use
By default, the administration pages can only be accessed if you are logged in with an administrator account. Since there are no users yet, openHAB will ask you to create an administrator account.
# Add geographic information
After creating an admin user, you will be guided through a first-time setup wizard. Start by setting your language, region, and time zone. You can also set your location, or skip this step and complete it later.
# Install add-ons
You now have the option to install openHAB add-ons. Do this if you already know that you'll need specific add-ons (e.g. if you're upgrading from an older openHAB system), or skip this step if you prefer to install add-ons individually. You can always install/remove add-ons in the future, enabling you to modify and improve your system over time.
After finishing the wizard you will get a welcome message and be redirected to your dashboard.
# Log into the dashboard
You'll be automatically logged into your dashboard using your administrator when the setup wizard is completed. openHAB doesn't require you to sign in, but you can only access the settings if you're logged in as an administrator.
Currently the only way to add additional users or manage existing ones (including changing passwords and attributing roles) is with the Console.
# Modify Settings
You already completed the required steps of choosing your language, region, and time zone in the setup wizard, and are now logged in as an administrator. If you didn't add a geographic location during setup, you can do so via the Settings. You can also set your preferred measurement system (openHAB defaults to the Metric system).
# Set your geographic location (latitude and longitude) and measurement system
In the left-hand menu under Administration, select Settings to open the Settings page.
Under System Settings, select Regional Settings.
Under Location, click the Map button to add your geographic coordinates.
If you also want to set your measurement system, click "Show advanced" and choose between Metric and Imperial.
# Additional Settings
The following settings are available but not covered by this tutorial.
|Network Settings||Configure the default networks OH listens on and broadcasts on, IPV6, etc.|
|Audio||Configure the default microphone and audio destination|
|Ephemeris||Configure day types (e.g. which days of the week are weekends) and import your locale's holidays. Can be used in rules.|
|API Security||Allows Basic Auth to be used for accessing protected parts of the openHAB API. By default an authorization token or OAuth2 is required.|
|Addon Management||Choose whether to download add-ons when they are installed or use a locally stored collection of all the add-ons.|
|Persistence||Set the system-wide default persistence engine.|
|Json Storage||Settings for the automatic backup of UI generated configs.|
|Inbox||Settings that affect how Items are shown and approved in the Inbox where discovered Things appear.|
|Charts||Default settings for generated charts.|
|Voice||Settings for voice-to-text, text-to-voice and human language processing.|
|Other Services||The items that appear here will change based on the set of add-ons installed. These are places to configure those bindings and capabilities (e.g. set up the connection for InfluxDB Persistence).|