==================
Here you can find change log.
This is a main controller, that starts all other ioBroker adapters.
Official Web-Site: http://iobroker.net
Forum: http://forum.iobroker.net
Issue Tracker: http://iobroker.net:8000 (please leave your issues there and not on github)
ioBroker wiki: https://github.com/ioBroker/ioBroker/wiki/Home-(English)
Explanation of the concept: https://github.com/iobroker/iobroker
This is a Javascript/Node.js implementation of an ioBroker controller.
Node.js (Node.js version >= 0.8, including npm)
wget http://download.iobroker.org/nodejs_0.10.22-1_armhf.deb ; sudo dpkg -i nodejs_0.10.22-1_armhf.deb ; rm nodejs_0.10.22-1_armhf.deb
sudo dpkg -i nodejs_0.10.22-1_armhf.deb
rm nodejs_0.10.22-1_armhf.deb```
### Install js-controller on linux
* Create and change to the directory under which you want to install ioBroker.
```sudo mkdir /opt/iobroker ; sudo chown $USER.$USER /opt/iobroker ; cd /opt/iobroker```
* install npm packet
```npm install iobroker```
### Start ioBroker controller on linux
* run ```./iobroker start``` in the ioBroker directory to start the ioBroker controller in the background
* watch the logfile ```tail -f log/iobroker.log```
or
* run ```node node_modules/iobroker.js-controller/controller.js``` to start the ioBroker controller in foreground and watch the log on console
### Install js-controller on windows
* Create and change to the directory under which you want to install ioBroker.
```mkdir C:/iobroker```
```cd C:/iobroker```
* install npm packet from created directory
```npm install iobroker```
### Start ioBroker controller on windows
* run ```iobroker start``` in the ioBroker directory to start the ioBroker controller in the background console
* check the logfile ```node_modules/iobroker.js-controller/log/iobroker.log```
or
* run ```node node_modules/iobroker.js-controller/controller.js``` to start the ioBroker controller in foreground and watch the log on console
### Admin UI
The admin adapter starts a web-server that hosts the Admin UI. Default port is 8081, so just open http://<iobroker>:8081/
If port 8081 is occupied, you can install second Admin UI on alternate port and change port for first admin UI:
* run ```./iobroker add admin --enabled --port 8090``` and go to the http://<iobroker>:8090/. Of course you can change port 8090 to other one.
### Install more adapters
* ```./iobroker add <adapter-name>```
* ```./iobroker add <adapter-url>``` (todo)
After Installation of an Adapter you should edit it's configuration. Go to the tab "instances" in the Admin UI.
By clicking a adapter instance you can directly enable it by checking the enabled checkbox. Press enter to save or escape
to cancel.
To edit the adapters configuration mark the adapter row and click the note icon.
To enable or disable the adapter click on the pencil icon in the according row.
## Using REDIS as States-DB
There is a possibility to use REDIS as states database. It is reasonable to do that for big installations or for systems with performance problems.
It is possible to switch anytime between REDIS and In-Memory Javascript DB. The only problem, that all states must be updated by adapters again (values will be lost).
Objects and configuration are not affected.
To install REDIS on linux/debuan just write: ```apt-get install redis-server``` .
If you plan to use mulithost installation you must allow connections to redis from any address (default only 127.0.0.1).
To do that edit file */etc/redis/redis.conf* (```sudo nano /etc/redis/redis.conf```) and replace ```bind 127.0.0.1``` with ```bind 0.0.0.0``` .
Don't forget to restart redis after that. (```sudo /etc/init.d/redis-server restart```)
To install on windows download latest release here [https://github.com/MSOpenTech/redis/releases](https://github.com/MSOpenTech/redis/releases).
To switch to REDIS write in the console following:
iobroker stop iobroker setup custom
And then:
Type of objects DB [file, couch, redis], default [file]: Host of objects DB(file), default[127.0.0.1]: Port of objects DB(file), default[9001]: Type of states DB [file, redis], default [file]: redis Host of states DB (redis), default[127.0.0.1]: Port of states DB (redis), default[6379]: Data directory (file), default[../../../iobroker-data/]: Host name of this machine [FastPC]: creating conf/iobroker.json
Note that in fourth line it was entered **redis**.
Now ioBroker can be started.
Of course redis must be first installed and firewall rules must be checked.
To switch back to JS States write the same commands again, just instead of **redis** in fourth line write nothing and press ENTER.