# \[HOW TO\] CLI install method

**URL:** <https://community.homey.app/t/how-to-cli-install-method/198>\
**Category:** Tutorials\
**Tags:** homey-pro\
**Created:** [August 23, 2018, 1:18pm UTC](https://community.homey.app/t/how-to-cli-install-method/198 "2018-08-23T13:18:12Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![HansieNL](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/hansienl/32/10634_2.png) [@HansieNL](https://community.homey.app/u/HansieNL)\
**Post date:** [August 23, 2018, 1:18pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/1 "2018-08-23T13:18:12Z")

</div>

# Homey Pro only!!!

It does not work this way with Homey (cloud), it only supports `CLI run` which is there only for development purposes.

## 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/](https://nodejs.org/) and install it on your computer.

## Download the app you want to install from GitHub

- Go to the repository on [GitHub](https://github.com/) (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 --remote`  
`homey app run --clean`  
`homey app run --path /path/to/my/app/folder`

\*\* `--remote` for bypassing the Local docker requirement and run in the Homey Pro self.

**For installing app:**  
`homey app install`

## Resource

[Command Line Interface for Homey App Development](https://github.com/athombv/node-athom-cli/blob/master/README.md)

[Homey CLI](https://apps.developer.homey.app/the-basics/getting-started/homey-cli)

---

<div class="post-metadata">

**Author:** ![uNiiek](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/uniiek/32/92_2.png) [@uNiiek](https://community.homey.app/u/uNiiek)\
**Post date:** [August 24, 2018, 7:18am UTC](https://community.homey.app/t/how-to-cli-install-method/198/2 "2018-08-24T07:18:58Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![Ruud](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/ruud/32/64214_2.png) [@Ruud](https://community.homey.app/u/Ruud)\
**Post date:** [January 20, 2019, 12:39pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/5 "2019-01-20T12:39:40Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![Betonmoewe](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/betonmoewe/32/8899_2.png) [@Betonmoewe](https://community.homey.app/u/Betonmoewe)\
**Post date:** [April 28, 2019, 11:17am UTC](https://community.homey.app/t/how-to-cli-install-method/198/6 "2019-04-28T11:17:46Z")

</div>

Thanks a lot! With your help, I’m now on 2.1.9

---

<div class="post-metadata">

**Author:** ![ktd](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/ktd/32/11761_2.png) [@ktd](https://community.homey.app/u/ktd)\
**Post date:** [September 28, 2019, 2:11pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/7 "2019-09-28T14:11:32Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![Rocodamelshekima](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/rocodamelshekima/32/8209_2.png) [@Rocodamelshekima](https://community.homey.app/u/Rocodamelshekima)\
**Post date:** [September 28, 2019, 2:14pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/8 "2019-09-28T14:14:50Z")

</div>

That will be correct!

---

<div class="post-metadata">

**Author:** ![ktd](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/ktd/32/11761_2.png) [@ktd](https://community.homey.app/u/ktd)\
**Post date:** [September 28, 2019, 2:16pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/9 "2019-09-28T14:16:19Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![ktd](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/ktd/32/11761_2.png) [@ktd](https://community.homey.app/u/ktd)\
**Post date:** [September 28, 2019, 2:21pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/10 "2019-09-28T14:21:26Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![HansieNL](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/hansienl/32/10634_2.png) [@HansieNL](https://community.homey.app/u/HansieNL)\
**Post date:** [September 28, 2019, 9:01pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/11 "2019-09-28T21:01:58Z")

</div>

Updated.

---

<div class="post-metadata">

**Author:** ![PetervdK](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/petervdk/32/20669_2.png) [@PetervdK](https://community.homey.app/u/PetervdK)\
**Post date:** [October 6, 2019, 2:37pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/12 "2019-10-06T14:37:22Z")

</div>

I try to install an adjusted version of the Neo Coolcam app, but i keep getting “Homey Offline” after validation:  
 ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/a/b/abd2454e570dfb49545c1e13ce9358cd5f74ed16.png)  
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?

---

<div class="post-metadata">

**Author:** ![robertklep](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/robertklep/32/160628_2.png) [@robertklep](https://community.homey.app/u/robertklep)\
**Post date:** [October 6, 2019, 3:19pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/13 "2019-10-06T15:19:23Z")

</div>

> [@PetervdK](#):
>
> What am i doing wrong?

Try searching for [cli homey offline](https://community.homey.app/search?q=cli%20homey%20offline). 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.

---

<div class="post-metadata">

**Author:** ![Peter\_de\_Vos](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/peter_de_vos/32/151925_2.png) [@Peter\_de\_Vos](https://community.homey.app/u/Peter_de_Vos)\
**Post date:** [October 6, 2019, 3:42pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/14 "2019-10-06T15:42:21Z")

</div>

> [@PetervdK](#):
>
> Other question: If i have the official app already installed, will a CLI install overwrite that version?

Yes, it will. It also will not get updates anymore.

---

<div class="post-metadata">

**Author:** ![PetervdK](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/petervdk/32/20669_2.png) [@PetervdK](https://community.homey.app/u/PetervdK)\
**Post date:** [October 6, 2019, 5:18pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/15 "2019-10-06T17:18:46Z")

</div>

Thanks

---

<div class="post-metadata">

**Author:** ![Rocodamelshekima](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/rocodamelshekima/32/8209_2.png) [@Rocodamelshekima](https://community.homey.app/u/Rocodamelshekima)\
**Post date:** [October 6, 2019, 5:43pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/20 "2019-10-06T17:43:44Z")

</div>

Please keep it on-topic. Off-topic posts will be deleted without further notice.

---

<div class="post-metadata">

**Author:** ![Phuturist](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/phuturist/32/49_2.png) [@Phuturist](https://community.homey.app/u/Phuturist)\
**Post date:** [November 14, 2019, 6:07pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/21 "2019-11-14T18:07:54Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![HansieNL](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/hansienl/32/10634_2.png) [@HansieNL](https://community.homey.app/u/HansieNL)\
**Post date:** [November 15, 2019, 11:26pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/22 "2019-11-15T23:26:30Z")

</div>

Inhaven’t seen the new instructions yet. If you like you can send them via pm and I’ll add them to my post.

---

<div class="post-metadata">

**Author:** ![Linden85](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/linden85/32/17207_2.png) [@Linden85](https://community.homey.app/u/Linden85)\
**Post date:** [November 24, 2019, 10:52pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/23 "2019-11-24T22:52:35Z")

</div>

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

Wat doe ik fout? 🤔

---

<div class="post-metadata">

**Author:** ![anon8748058](https://avatars.discourse-cdn.com/v4/letter/a/ebca7d/32.png) [@anon8748058](https://community.homey.app/u/anon8748058)\
**Post date:** [November 25, 2019, 8:38am UTC](https://community.homey.app/t/how-to-cli-install-method/198/24 "2019-11-25T08:38:45Z")

</div>

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)

---

<div class="post-metadata">

**Author:** ![Linden85](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/linden85/32/17207_2.png) [@Linden85](https://community.homey.app/u/Linden85)\
**Post date:** [November 27, 2019, 10:01pm UTC](https://community.homey.app/t/how-to-cli-install-method/198/25 "2019-11-27T22:01:54Z")

</div>

![cli](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/f/8/f8365fa33686becda38271514eca74d09cff5ea0.png)

this is the error after step 1 (what i’m doing wrong?)

---

<div class="post-metadata">

**Author:** ![anon8748058](https://avatars.discourse-cdn.com/v4/letter/a/ebca7d/32.png) [@anon8748058](https://community.homey.app/u/anon8748058)\
**Post date:** [November 28, 2019, 4:45am UTC](https://community.homey.app/t/how-to-cli-install-method/198/26 "2019-11-28T04:45:39Z")

</div>

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/](https://nodejs.org/download/release/latest-v8.x/)

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

[Next page](https://community.homey.app/t/how-to-cli-install-method/198.md?page=2)
