Homey Community Forum

[HOW TO] CLI install method

Installing Node.js

  • 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

Setup Node.js

  • 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: homey --help

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

Homey och energimätning Aeotec
Ikea smart plug - beschikbaar in nld
Cannot include Aeotec Garage Door Opener
[APP] Bluesound
Fibaro Motion Sensor does not report/stuck
Toon en homey
Home Easy bedienen met Homey
Developer Code/App zu Homey hinzufügen
Probleem met Ring & Homey
Ring Doorbell Autorisation button not working
Aeotec NanoMote Quad
Mi Homey
[APP] Shelly
Besoin d’aide avec Walli
[APP] Yeelights
Alternative apps (store) [Not in app store]
[APP] Denon Heos app form @nlrb [Not in app store]
Denon - Heos ''apparaat niet beschikbaar''
Mi Homey
Fibaro/Z-wave probleem (unsecure include)
[APP] Yeelights
Adding aeotec siren 6 to homey
Tradfri Remote an Homey?
Probleem met Ring & Homey
Ring Doorbell V2
Cannot find/add Ring devices
Sending multiple Zwave commands at once
Hue Go - Philips Hue Zigbee app
TP-Link Smart Devices - central topic
Unable to add Fibaro Walli Dimmer
Fritzbox Bridge
[APP] Nuki Bridge Api (not in app store)
[APP] Magic Home LED Controllers
Philips Hue GU10 white ambiance alleen simpel zigbee
[APP] SMA Solar devices
[APP] Magic Home LED Controllers
Connection Home Assistant to Homey
Heimdall - Let Homey watch over your home
[APP] SMA Solar devices
Xiaomi Mi Home App for WiFi devices
Icons toevoegen
[APP] Shelly
Kan Shelly app niet installeren op Homey
Add Z-Wave device non-secure?
Hihome slimme stekker
Aeotec Door/Window Sensor 7
Homey Harmony Hub (v2.0.3)
Prometheus.io exporter
WeatherFlow's Smart Weather Station
Xiaomi Mi Home App for WiFi devices
Xiaomi Mi Home App for WiFi devices
[APP] SMA Solar devices
Fibaro motion sensor not recoginised
[APP] DoorBird
Github code to app?
Welche inoffiziellen Apps nutzt ihr?
Xiaomi Mi Home App for WiFi devices
Vision security app
Z-rain delete
Greenwave Systems v.2.0 removed power capabilities
[APP] Bluesound
Vision security app
Oomi devices
Xiaomi mi flora sensor/ropot app
TP-Link Smart Devices - central topic
Fibaro by Athom
[APP] Magic Home LED Controllers
Yeelights worden niet meer herkend
OpenWeatherMap - central topic
See all actual temperatures in 1 overview
Plugwise stretch 2 app?
[Beginner] Turn electricity off when you shut down PC
How do I detect a specific computer being turned on and run a flow?
App von GitHub
Belkin wemo support stopped?
Guide to Connecting gBridge to Homey for Google Assistant
Het grote Homey 2.0.0 stable discussie topic [NL]
ScreenLine Remote (v0.0.6) [WIP][Alpha Invite only]
MQTT Hub/Gateway
Heimdall - Let Homey watch over your home
Homey triggert niet een zeg kaartje als ik een spraak commando uitvoer
Homey 2.0.0 Community App Compatibility List
TP-Link Smart Devices - central topic
Heating Schedule App
Fibaro Shutter 3 not supported yet?
Heimdall - Let Homey watch over your home
Homey Harmony Hub (v2.0.3)
Can't add Fibaro Relay Switch FGS-212 to the Homey 2.0
Heimdall - Let Homey watch over your home
Sonos Say
Unauthorized Tado thermostat and thermostatic
[APP] Twinkly
Global Caché
[APP] Shelly
[APP] Bluesound
Xiaomi Mi Home App for WiFi devices
Itho, hoe kan ik deze Itho App installeren?
My Nodered flow for setting lights. Is this possible with Homey?
[APP] Shelly
[APP] Shelly
App Update Checker
Somfy Protect / Home Alarm (formally known as MyFox)
[APP] Yeelights
[APP] Bluesound
Change device type
Zwave device’s as a repeater
Forsinkelse (lag) i flows?
Greenwave Systems v.2.0 removed power capabilities
Aeotec Home Energy Meter Gen5 - 3 clamp
Fibaro/Z-wave probleem (unsecure include)
[APP] Shelly
Yeelight not working
Import devices from Home Assistant, MQTT
[APP] Shelly

Here can you find a video tutorial about installing apps with Homey CLI:


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

1 Like

@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.

That will be correct!

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. :smiley:

1 Like

@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.


1 Like

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?

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.

1 Like


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.

1 Like

Helaas lukt mij ook alleen stap 1.
Ik krijg helaas niet het webadres te zien van homey.

Wat doe ik fout? :thinking:

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