Homey Pro only!!!
It does not work this way with Homey (cloud), it only supports
CLI run which is there only for development purposes.
Check Node.js version on Homey:
Homey App: Settings - General - About - Node.js version
Download Node.js (use Homey’s version or higher) from
https://nodejs.org/ and install it on your computer.
Download the app you want to install from GitHub
Go to the repository on
GitHub (the correct link for the app you want to install is at the bottom of the app store page or given directly through the support topic) On GitHub choose the right branch to install, master is usually the main branch as released in the app store but there could be other branches like a debug branch.
From the correct branch click the
Clone or Download > Download Zip button to download the app in zip format
Unpack the zip file
Open command prompt and install the Homey CLI tools:
npm install -g homey
Log in to your Homey from the command prompt
homey login (allow access through the webpage that is opened)
Navigate to the folder of the app that you have extracted in the previous step
For help on the available commands:
For list (un)selecting Homey:
homey homey list
homey homey select
homey homey unselect
For running app:
homey app run
homey app run --clean
homey app run --path /path/to/my/app/folder
For installing app:
homey app install
Command Line Interface for Homey App Development
August 24, 2018, 7:18am
Here can you find a video tutorial about installing apps with Homey CLI:
January 20, 2019, 12:39pm
Here a new video with the current way of installing apps outside the app store
Thanks a lot! With your help, I’m now on 2.1.9
September 28, 2019, 2:11pm
@HansieNL Does this mean that I can download an app from GitHub, make changes and install to my Homey?
I want to try a small “fix” in an existing app and see if that work.
September 28, 2019, 2:16pm
Cool! Then I can try the change on my Homey and if it works I can let the dev know. If it’s not working I can keep quiet and pretend that I didn’t even try.
September 28, 2019, 2:21pm
@HansieNL Athom seem to have change where you an see the Node.js version so you might want to update your excellent guide.
Its now under Settings - General - About - Node.js version.
I try to install an adjusted version of the Neo Coolcam app, but i keep getting “Homey Offline” after validation:
Homey is online and responding.
What am i doing wrong?
Other question: If i have the official app already installed, will a CLI install overwrite that version?
What am i doing wrong?
Try searching for
cli homey offline. It’s a common issue, in my opinion caused by Homey’s not-so-stellar networking setup. Rebooting Homey and/or your router and/or your WiFi access point might solve it.
Yes, it will. It also will not get updates anymore.
Please keep it on-topic. Off-topic posts will be deleted without further notice.
@HansieNL could you update this topic with the new
homey package for installing apps. I send users from my apps to this topic if they want to debug their issues but it’s now outdated with the new app store and installation process.
Inhaven’t seen the new instructions yet. If you like you can send them via pm and I’ll add them to my post.
Helaas lukt mij ook alleen stap 1.
Ik krijg helaas niet het webadres te zien van homey.
Wat doe ik fout?
In English please.
Which step do you mean exactly? You have installed node.js, the release you want to install and installed the Homey CLI tools? (npm install -g homey)
this is the error after step 1 (what i’m doing wrong?)
Which version of node.js did you download?
Rather than using the latest, try using the one Homey uses
At moment of writing this is version 8.16.2
Not saying this is the solution, just to make sure it isn’t