-
Notifications
You must be signed in to change notification settings - Fork 0
Linux OS X
- Installation via apt-get
- Manual installation (alternativly - including openHAB Designer)
- Yocto Layer
Note: for Hardware specific approach (e.g. ARM boards like Raspberry Pi) please visit the Hardware FAQ.
su -
echo "deb http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main" | tee /etc/apt/sources.list.d/webupd8team-java.list
echo "deb-src http://ppa.launchpad.net/webupd8team/java/ubuntu trusty main" | tee -a /etc/apt/sources.list.d/webupd8team-java.list
apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys EEA14886
apt-get update
apt-get purge openjdk* (to remove previously installed lower versions)
apt-get install oracle-java8-installer
exit
$ sudo nano /etc/apt/sources.list.d/openhab.list
Add the following line in the editor:
deb http://repository-openhab.forge.cloudbees.com/release/1.x.y/apt-repo/ /
Replace the x and the y by the appropriate version numbers. You can find the latest stable version at the OpenHAB downloads page.
Exit with CTRL X then Y
$ sudo apt-get update
$ sudo apt-get install openhab-runtime
The packages are not signed therefore you will get a warning!
Use "apt-cache search openhab" to get a list of all packages. Install the add-ons as you need them using "apt-get install".
$ sudo apt-cache search openhab
$ sudo apt-get install openhab-addon-binding-xy
In terms of configuration please visit the configuration page(s).
$ sudo /etc/init.d/openhab start
The server will run unprivileged using the account "openhab". The deb installer adds openHAB to the system startup.
openHAB comes with a built-in user interface. It works on all webkit-based browsers like Chrome, Safari, etc. Point your browser to http://localhost:8080/openhab.app?sitemap=yourname
and you should be looking at your sitemap.
- openHAB engine (including /webapps folder) is installed in /usr/share/openhab.
- Configuration is located at /etc/openhab
- log-files are stored in /var/log/openhab
Changed configuration files will be retained even on upgrades!
$ sudo apt-get update
$ sudo apt-get upgrade
TBD
WARNING: this quick setup is an example for a KNX environment. You need different addons and configurations for other bindings.
The openHAB runtime comes as a platform-independent zip file. To install it, follow these simple steps:
- You will need to install Java if not already installed. Go to http://java.com/ to get it. For ARM based systems and Synology Diskstation, see Hardware FAQ for instructions on getting Java.
- Unzip the
openhab-runtime-<version>.zip
to where it is intended to be running from, e.g./opt/openhab
. - Copy the bindings you have downloaded -
knx-binding-<version>.jar
andhttp-binding-<version>.jar
- to the "addons" directory. - Create a personal configuration file
configurations/openhab.cfg
and add the appropriate configuration parameters fromconfigurations/openhab_default.cfg
(depending on the bindings you've copied).
The openHAB designer comes as a platform-dependent zip, so choose the right type for your platform. To install it, follow these simple steps:
- Unzip the
openhab-designer-<platform>-<version>.zip
to some directory, e.g./opt/openhab-designer
- Launch it by the executable
openHAB-Designer
- Select the "configurations" folder of your runtime installation in the folder dialog that is shown when selecting the "open folder" toolbar icon.
For please visit the configuration page(s).
- Launch the runtime by executing the script
start.sh
openHAB comes with a built-in user interface. It works on all webkit-based browsers like Chrome, Safari, etc. Point your browser to http://localhost:8080/openhab.app?sitemap=yourname
and you should be looking at your sitemap.
For people who make their own linux distribution using Yocto, there is a openHAB layer available:
https://github.com/ulfwin/meta-openhab
You can also find it through the very convenient layer search site:
http://layers.openembedded.org/layerindex/branch/master/layers/
The layer contains one recipe that install both the runtime engine and addons. Check the README for specific instructions for the layer. How to add and use a layer is not covered here (you need to know that in order use Yocto in the first place), but some explanation can be found here:
http://www.yoctoproject.org/docs/1.6/dev-manual/dev-manual.html#understanding-and-creating-layers
Installation
Community
- Support
- News Archive
- Presentations
- How to Contribute
- IDE Setup
- How to Implement a Binding
- How to Implement an Action
- Projects using openHAB
- User Interfaces
- Classic UI
- iOS Client
- Android Client
- GreenT UI
- CometVisu
- Automation
- Scripts
- Rules
- Actions
- Bindings
- AlarmDecoder Binding
- Anel Binding
- Asterisk Binding
- Astro Binding
- BenQ Projector Binding
- Bluetooth Binding
- Comfo Air Binding
- Config Admin Binding
- CUL Binding
- CUPS Binding
- DAIKIN Binding
- Davis Binding
- digitalSTROM Binding
- DMX512 Binding
- DSC Alarm Binding
- DSMR Binding
- Ecobee Binding
- EDS OWSever Binding
- eKey Binding
- Energenie Binding
- EnOcean Binding
- Epson Projector Binding
- Exec Binding
- Freebox Binding
- Freeswitch Binding
- Fritz AHA Binding
- Fritz!Box Binding
- FS20 Binding
- Global Cache IR Binding
- GPIO Binding
- HAI/Leviton OmniLink Binding
- HDAnywhere Binding
- Heatmiser Binding
- Homematic / Homegear Binding
- HTTP Binding
- IEC 62056-21 Binding
- IHC / ELKO Binding
- ImperiHome Binding
- Insteon Hub Binding
- Insteon PLM Binding
- IRtrans Binding
- jointSPACE-Binding
- KNX Binding
- Koubachi Binding
- Leviton/HAI Omnilink Binding
- Lg TV Binding
- MAX!Cube-Binding
- MAX! CUL Binding
- MiLight Binding
- MiOS Binding
- Modbus TCP Binding
- MPD Binding
- MQTT Binding
- MQTTitude binding
- Neohub Binding
- Nest Binding
- Netatmo Binding
- Network Health Binding
- Network UPS Tools Binding
- Nibe Heatpump Binding
- Nikobus Binding
- Novelan/Luxtronic Heatpump Binding
- NTP Binding
- One-Wire Binding
- Onkyo AV Receiver Binding
- Open Energy Monitor Binding
- OpenPaths presence detection binding
- OpenSprinkler Binding
- OSGi Configuration Admin Binding
- Philips Hue Binding
- Piface Binding
- pilight Binding
- Pioneer-AVR-Binding
- Plugwise Binding
- PLCBus Binding
- Primare Binding
- Pulseaudio Binding
- RFXCOM Binding
- Samsung AC Binding
- Samsung TV Binding
- Serial Binding
- Satel Alarm Binding
- Snmp Binding
- Somfy URTSI II Binding
- Sonos Binding
- Squeezebox Binding
- Swegon ventilation Binding
- System Info Binding
- TCP/UDP Binding
- Tellstick Binding
- TinkerForge Binding
- Tivo Binding
- VDR Binding
- Velleman-K8055-Binding
- Wake-on-LAN Binding
- Waterkotte EcoTouch Heatpump Binding
- Weather Binding
- Wemo Binding
- Withings Binding
- XBMC Binding
- xPL Binding
- Yamahareceiver Binding
- Zibase Binding
- Z-Wave Binding
- Application Integration
- Asterisk
- Google Calendar
- Linux Media Players
- ROS Robot Operating System
- Telldus Tellstick
- Zoneminder
- Rooted Wink Hub
- Persistence
- db4o Persistence
- rrd4j Persistence
- MySQL Persistence
- MongoDB Persistence
- Sen.Se Persistence
- Cosm Persistence
- Logging Persistence
- Exec Persistence
- MQTT Persistence
- InfluxDB Persistence
- JPA Persistence
- Misc
- Transformations
- REST-API
- Security
- Service Discovery
- Dropbox Bundle
- Voice Control
Samples
- Item definitions
- Sitemap definitions
- Binding configurations
- Comfo Air Binding
- Nest Binding (new)
- Nest Thermostat
- Rollershutter Groups
- Squeezebox
- WAC Binding
- WebSolarLog
- Rules
- Misc. rule examples
- Alarm Clock
- Convert Farenheit to Celcius
- Taking Rules to New Heights
- Reusable Rules via Functions
- Items, Rules and more Examples of a SmartHome
- REST Examples
- Tips and Tricks
- Scripts
- Syntax highlighting for external editors
- Update-Scripts
- Controlling openHAB with Android
- Usecase examples
Release Notes