Weihnachtsangebot 2025! 🎄

[oberstel]

This little how-to describes the installation of ioBroker on Windows 10, using the out of the box Windows Subsystem for Linux (WSL) which is added to Windows since the Windows 10 Anniversary Update.

Windows 10's Bash Shell is a full, Ubuntu based Bash Shell, that can run Linux software directly on Windows - This is not a virtualization or a Linux environment compiled for Windows like Cygwin.

For more information about Bash on Windows 10, please visit: https://msdn.microsoft.com/en-us/commandline/wsl/about

The ioBroker on WSL setup might be useful to have an isolated development environment or to check things out - The intent is not to run a productive ioBroker system due to missing autostart capabilities of Windows bash, which might limit the availability of ioBroker.

Please note: You need to have at least Windows Build 14951 with Ubuntu 16.04 Xenia running to have a proper Linux environment. Even though WSL is part of Windows 10 since Build 14939, but in all builds below 14951 some APIs are not implemented and Node.js is not running very well. And, please keep in mind that WSL is still beta!

Step-by-step guide:

1. Check which Windows Operation System you are running

• a. Open Settings > System > About

b. Check OS Build (must be 14951 or higher)

c. Check System Type (must be 64-bit operating system) 

2. Turn-on Developer Mode

• a. Open Settings > Update & Security > For developers

b. Select the Developer Mode radio button 

3. Enable the Windows Subsystem for Linux

• a. Open PowerShell as Administrator

````
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
````b. Reboot 

4. Install Bash on Windows

• a. Open Command Prompt (cmd)````
  bash

```` 

5. Create a proper User

• a. Enter a UNIX user name

b. Enter new UNIX password 

6. Close the Bash shell

7. Start Bash on Ubuntu on Windows over the Start menu

8. Update the Windows 10 Linux environment

sudo apt-get update
sudo apt-get upgrade
````Note: This isn't really necessary but it feels good to have an up-to-date system. 

9. Install Node.js with the standard Node Package Manager (npm) and create a symbolic link

wget -qO- https://deb.nodesource.com/setup_4.x | sudo bash -
sudo apt-get install nodejs
sudo ln -s /usr/bin/nodejs /usr/local/bin/node
````Note: As of writing, this installs Node.js v4.7.3 with npm v2.15.11 

10. Check Node.js and npm version

node -v
npm -v
```` 

11. Create the ioBorker home directory and install ioBroker using npm

sudo mkdir /opt/iobroker
sudo chmod 777 /opt/iobroker
cd /opt/iobroker
sudo npm install iobroker --unsafe-perm
````Note: this will take a while and you might see some deprecation warnings which can be ignored. 

12. Check if ioBroker is running well

cat /opt/iobroker/log/*.log
```` 

13. Open ioBroker Admin Interface with your browser

• http://localhost:8081

If you have any issues with this guideline, or running ioBorker on WSL, please let me know.

[oberstel]

Wer seinen Rechner erst einmal auf die o.g. Windows 10 updaten muss, dem empfehle ich die Seite von den Deskmodder Kollegen:

https://www.deskmodder.de/blog/?s=iso

Unter diesem Link findet Ihre alle offiziell von Microsoft im Rahmen des Windows Insiderprogramms veroeffentlichten Windows 10 builds.

[Homoran]

@oberstel:

Wer seinen Rechner erst einmal auf die o.g. Windows 10 updaten muss, `
Ich hatte mich auch schon gefragt wo die 14951 herkommt und gegoogelt.

Die scheint aber noch nicht stabil zu sein.

Warum verschieben?

Text ist zwar englisch aber Inhalt doch IMHO für alle interessant - Sonst geht es noch unter, oder?

Gruß

Rainer

[oberstel]

@Homoran:

Die scheint aber noch nicht stabil zu sein. ` ja, das ist richtig. Mit dem kommenden Creators Update (April 2017) gibt es dann eine stabile Windows 10 build, aber WSL wird vermutlich auch weiter Beta sein.

Ich nutze das aktuelle Build 15025 auch auf produktiv. Die unzulaenglichkeiten sind ueberschaubar.

@Homoran:

Warum verschieben?

Text ist zwar englisch aber Inhalt doch IMHO für alle interessant - Sonst geht es noch unter, oder? ` ich bin ja noch ganz neu hier und hatte erst nach dem abschicken gesehen, dass es hier auch ein englisches Forum gibt… Wollte nur ordentlich sein;-)

ioBroker ist ein so tolles Projekt, dass auch User in anderen Laendern in den Genuss kommen sollten. Daher wuerde ich HowTos und Adapter Dokus immer auf Englisch verfassen.

[Homoran]

@oberstel:

Daher wuerde ich HowTos und Adapter Dokus immer auf Englisch verfassen. `
Auch hier ein ganz klares Jein ;-)

In vielen Dingen, die sich an (deutsche) Einsteiger richten, die tlw. keine Ahnung von Linux & Co. haben, muss die Doku, das HowTo auf deutsch sein.

Ein HowTo zu einem Thema wie du es erstellt hast, ist sicherlich an fortgeschrittenere User gerichtet, da könnte man schon eher davon ausgehen, dass diese auch Englisch verstehen.

Wie machen wir es jetzt den international usern bekannt?

möchtest du einen Link im englischsprachigen Forum setzen?

Gruß

Rainer

[oberstel]

@Homoran:

In vielen Dingen, die sich an (deutsche) Einsteiger richten, die tlw. keine Ahnung von Linux & Co. haben, muss die Doku, das HowTo auf deutsch sein. ` Ok, Euer Projekt, Eure Regeln

Ich bin bereits dabei einen Adapter für PJLink kompatibele Projektoren und Bildschirme zu erstellen. Den Code werde ich also Englisch commentieren und die Adapterbeschreibung in Deutsch.

@Homoran:

Ein HowTo zu einem Thema wie du es erstellt hast, ist sicherlich an fortgeschrittenere User gerichtet ` Echt? Das haette ich jetzt ganz anders eingeschaetzt…

@Homoran:

Wie machen wir es jetzt den international usern bekannt?

möchtest du einen Link im englischsprachigen Forum setzen? ` Bitte verschiebe denn Eintrag einfach und ich mache morgen hier einen neuen im deutsch.

[Homoran]

@oberstel:

Ok, Euer Projekt, Eure Regeln `
Das klingt jetzt krass! Nicht dass wir aneinander vorbeireden.

Was http://www.iobroker.net angeht, so habe ich bisher den Großteil der deutschen Seiten geschrieben. Und da muss es deutsch sein.

Da habe ich mich vielleicht missverständlich ausgedrückt.

Wenn du einen Adapter baust, wirst du sicher auch auf Github ein readme haben, das wird üblicherweise auch in englisch gehalten.

Wenn ich dann eine Doku für diesen Adapter erstelle, mache ich diese auch auf Deutsch.

Leider sind die englischen Webseiten noch stiefmütterlich behandelt, da wir noch keinen native speaker dafür begeistern konnten hunderte Stunden nur so zum Spaß in die Doku zu stecken.

Auch der englischsprachige Teil dieses Forums ist bisher sehr wenig genutzt worden :( Es scheint also sehr wenige (nur) englischsprachige User zu geben (oder die nutzen alle google translate ;-) )

Im Moment werden die russischen Seiten auf Englisch übersetzt.

Ich denke mal, dass du ein native speaker sein könntest und wenn du möchtest kannst du dich da gerne einbringen.

Lass mich mal über eine sinnvolle Lösung schlafen.

Das Projekt lebt von der Community! Nicht nur von einzelnen, außerdem wird man leicht betriebsblind.

Gruß

Rainer

[oberstel]

@Homoran:

Das klingt jetzt krass! ` Nein, nein - Das war so gar nicht gemeint. Alles gut. Wie gesagt, ich bin ja noch neu hier…

@Homoran:

Ich denke mal, dass du ein native speaker sein könntest und wenn du möchtest kannst du dich da gerne einbringen. ` Nee, bin ich nicht. Westfale, Klartext ist meine Muttersprache ;-)

Ich bin es nur vom Job her gewohnt Dinge in englisch zu beschreiben und gerne kannst Du auf mich zurueck kommen wenn Du was uebersetzt haben moechtest. Ich arbeite mich ja gerade selber in die Themen Node.js und ioBorker ein. Daher waere es sogar ein Gewinn fuer beide.

Die community ist ja noch recht ueberschaubar… Und viele kommen sicher aus dem EQ3 Lager. Daher haben wir hier sicher keinen grossen Handlungsdruck fuer Englisch. Aber das project ioBroker selber hatte ich ehr international eingestuft (auch wegen dem russischen). Eine so grundlegende universelle Architektur ist ja auch was fuer Z-Wave, X10 oder EnOcean. Auch ein Adapter fuer Crestron ware toll, und diese ganzen Dinge finden viel in den USA Anwendung.

[Homoran]

@oberstel:

Klartext ist meine Muttersprache `
:mrgreen: :mrgreen: