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

Resource

Command Line Interface for Homey App Development

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

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

8 Likes

Here a new video with the current way of installing apps outside the app store

7 Likes

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:

2 Likes

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

Updated.

1 Like

I try to install an adjusted version of the Neo Coolcam app, but i keep getting “Homey Offline” after validation:
image
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

Thanks

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.

2 Likes

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

https://nodejs.org/download/release/latest-v8.x/

Not saying this is the solution, just to make sure it isn’t