This page is part of archived documentation for openHAB 2.5. Go to the current stable version


The QNAP NAS (opens new window) is a NAS server solution for your home, allowing the installation of additional packages. Please find all details about the openHAB package for QNAP here (opens new window).

AppCenter enabled

# How to install

Check that your NAS has the most recent firmware version. Follow the instructions shown if a new version is announced when opening the admin GUI.

  1. Download the QPKG from the releases section over on GitHub (opens new window).

  2. Create a directory for your addons, configurations and userdata, by either

    • Creating a share called "openHAB" (recommended)
    • Creating a folder called "openHAB" inside the "Public" share
    • Not creating any of them and therefore using .qpkg/openHAB2/distribution for all data (for testing or demonstration)
  3. Go to your NAS's App Center and make sure you have got "JRE" (for x86-CPU based NAS) or "JRE_ARM" (for ARM-CPU based NAS) installed. If that is not the case, go to the "Developer-Tools" section of the App Center, install the appropriate version and wait for a while until the Java installation has finished.

  4. Open the "Install manually" dialog in the App Center by clicking the gear-wheel on the upper-right corner of the App Center and choose the qpkg you have downloaded.

    AppCenter choose

  5. Confirm the installation

    AppCenter confirm

  6. Wait while the package is being installed

    AppCenter installing

  7. When finished just close the dialog and wait for a while until openHAB has completely started. This may take several minutes.

    AppCenter finished

  8. Access openHAB via "http://NAS_IP_or_DNS_address:8090". If the interface does not start, retry after another minute. The initial startup takes some time.

# How to uninstall

If you want to keep configuration files, copy them to a save place outside of the openhab-path.

  1. Go to the "App Center" and remove the app like any other.

  2. Additionally if wanted or needed, please remove the folders "addons", "conf" and "userdata" from the your directory, eg. "openHAB2" share or "Public"/openHAB2 If you have installed openHAB2 to .qpkg (see "How to install", third option) then all files get removed automatically.

# Known issues