Installation - ioBroker/ioBroker GitHub Wiki

Deprecated

New file could be found here https://github.com/ioBroker/ioBroker.docs/blob/master/docs/en/install/linux.md

Installation guide

This page contains a short description on how to install ioBroker. See below for more detailed and localized version of the installation steps.

Linux based systems and MacOS

Installing ioBroker

Please open a SSH shell. You do not need to use a root shell to install ioBroker. If a normal unprivilidged user exists you should start the installation with this user.

Then execute

curl -sL https://iobroker.net/install.sh | bash -

This will install ioBroker in 4 steps and show its progress:

  • Creating ioBroker directory (1/4)
  • Downloading installation files (2/4)
  • Installing ioBroker (3/4)
  • Finalizing installation (4/4)

At the end you should see

ioBroker was installed successfully Open http://localhost:8081 in a browser and start configuring!

The installer will create a new user called "iobroker" on your Linux system and configures anything that iobroker and the adapter can run as this user. root is not longer needed and also "sudo" is no longer needed. Please do not use it!

Configure ioBroker

Go to http://IP-Adresse:8081 in your browser.

To install adapters please use Admin UI in your browser or the ioBroker commandline commands like:

  • iobroker start/stop
  • iobroker install adaptername
  • iobroker add adaptername

https://github.com/ioBroker/ioBroker/wiki/Console-commands

Detailed Guide

Update Installation (Permissions, Access Rights, ...)

The installation as described above takes also care of setting correct permissions and access rights to files and also about special requirements. The installation logic will be enhances as soon as needed because additional requirements are added.

The version of your installation is included in a file called INSTALLER_INFO.txt in your ioBroker installation directory. You can always check in https://github.com/ioBroker/ioBroker/blob/master/CHANGELOG_INSTALLER_LINUX.md what was updated after you installed ioBroker.

For older installations or to update your installation to the latest installation version we have created a installation fixer script that is capable to update all installations to the same level. The changelog of this fixer can be found at https://github.com/ioBroker/ioBroker/blob/master/CHANGELOG_FIXER_LINUX.md

Running the Installation fixer is as easy as installing. Simply execute

curl -sL https://raw.githubusercontent.com/ioBroker/ioBroker/stable-installer/fix_installation.sh | bash -

and follow the instructions. You need to stop ioBroker before running the script.

Windows

Installation

Download installer On windows the former installation way ist still the way to go. So please prepare your sytem with nodejs 8.12+ and npm 6.4.1+

Then create a directory for ioBroker (e.g. C:\iobroker), an Administrator shell and change into this directory. Then run

npm install iobroker

and follow the instructions on screen.

Detailed Guide