Shopify CLI Stuck on "[nodemon] starting 'node serve/index.js'"

Topic summary

Main issue: Shopify CLI hangs during “shopify app serve,” stopping at “[nodemon] starting ‘node serve/index.js’” with no error output. A screenshot shows the process stuck at that log line.

Environment:

  • Shopify CLI: 2.20.1
  • Node.js: v16.16.0
  • Ruby: 3.1.2

Findings so far: Reinstalling the CLI did not help. App creation from the official template works, and the app appears installable. The suspected cause is tunneling: the CLI reports starting a tunnel, but the ngrok dashboard shows none; launching a tunnel directly via ngrok.exe does work.

Guidance offered: Try fully reinstalling the CLI (e.g., via Homebrew to update dependencies). Create a fresh test app with “shopify app create” and attempt installation via the CLI-provided link (requires a working tunnel). The original poster requested resources on setting up ngrok manually.

Status: Another participant reports the same symptom and asks for a solution. No confirmed fix or workaround has been posted; the thread remains open.

Notes: “ngrok tunnel” = a public URL forwarding to the local dev server, needed for app callbacks during development.

Summarized with AI on February 5. AI used: gpt-5.

Recently I’ve dabbling with the Shopify CLI and have consistently encountered the following issue. After creating an app through the given commands and trying the “shopify app serve” command, it freezes and fails to complete. With no error messages, I wasn’t able to figure out a solution myself and was hoping to see if anyone else had a solution.

Versions:

Shopify-cli: 2.20.1

Node.js: v16.16.0

Ruby: 3.1.2

Hey @Brayden2 - thanks for sharing this, definitely weird. I wasn’t able to replicate the error on my end.

A few general tips though, if you have tried them already are to uninstall and then re-install the CLI itself to see if it resolves the issue. The good thing about this, if you’re using something like Brew to manage dependencies is that it would automatically update these as well if required.

If you’ve already done this and the issue still persists - no worries. The next thing to check is to see if you’re able to create a test app using the “shopify app create” command and see if you’re able to install that through the link provided in the CLI ( if you have something like a ngrok tunnel set-up) to see if it will install that way.

Let me know if you’ve already given those two steps a try or if you do go ahead and try those and the error persists - happy to to keep digging into this with you.

1 Like

Thank you for the prompt response!

I’ve already tried reinstalling shopify-cli and it seems that everything is up to date. In addition, the app I’ve created was through the provided templates, and seems to be working fine. The main issue from what I can tell is that the cli isn’t able to create a tunnel despite it saying so. On my ngrok account, it doesn’t display a tunnel when executing the ‘shopify app serve’ command, which is in contrast to when I create a tunnel directly through ngrok.exe.

As things stand, I am incredibly unfamiliar with tunnels and have no clue how to complete the process manually. So, if it were possible to do so, are there any online resources which could explain how?

Hello Brayden2, have you solved your problem? I am experiencing precisely the same and having troubles. Do you mind taking a moment to explain the solution i.e. if you have solved it - it would also be much appreciated if you replied if you havent solved it?