--- title: Remote debugging of Node.js apps on Azure App Service... description: A step-by-step walkthrough shows how to remote debug Node.js applications running on Azure App Service on Linux using WebStorm. It covers starting the app with... canonical: https://daily.dev/posts/remote-debugging-of-node-js-apps-on-azure-app-service-from-webstorm-dsarotjfw twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: Remote debugging of Node.js apps on Azure App Service from WebStorm | daily.dev og:description: A step-by-step walkthrough shows how to remote debug Node.js applications running on Azure App Service on Linux using WebStorm. It covers starting the app with... og:url: https://daily.dev/posts/remote-debugging-of-node-js-apps-on-azure-app-service-from-webstorm-dsarotjfw og:image: https://api.daily.dev/og/posts/dSArOtjfw.png og:image:alt: Remote debugging of Node.js apps on Azure App Service from WebStorm og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # Remote debugging of Node.js apps on Azure App Service from WebStorm **[Maarten Balliauw](https://daily.dev/sources/maartenballiauw)** · 5 min read · 0 upvotes · 0 comments ## Summary A step-by-step walkthrough shows how to remote debug Node.js applications running on Azure App Service on Linux using WebStorm. It covers starting the app with node's --inspect flag, setting up an SSH tunnel via the Azure CLI webapp extension, forwarding the debugger port locally with SSH or Putty, and configuring a WebStorm Attach to Node.js/Chrome run configuration to connect and set breakpoints. ## Full article daily.dev links to this article rather than hosting it. Read it at the original source: ## Questions this post answers ### How do I remote debug a Node.js app running on Azure App Service on Linux from WebStorm? Start the app with node's --inspect=0.0.0.0:12345 flag set as the startup command in Azure App Service, then use the Azure CLI command 'az webapp remote-connection create -g RESOURCEGROUP -n WEBAPP -p 3008' to open an SSH tunnel. Forward the debugger port locally with 'ssh -L 12345:127.0.01:12345 root@127.0.0.1 -p 3008', then create a WebStorm Attach to Node.js/Chrome configuration pointing to localhost port 12345. _daily.dev surfaces walkthroughs like this for developers wiring up remote debugging across cloud and IDE tooling._ ### Why doesn't Node.js remote debugging on Azure App Service on Linux work automatically even though Microsoft said it should just work? At the time debugging was still in public preview, and not all Azure regions had the necessary backend support deployed yet. A workaround required manually starting the Node.js process with the --inspect flag as the App Service startup command, since the automatic setup described in Microsoft's announcement did not function in every region. _Developers chasing preview-feature quirks across cloud regions track fixes like this on daily.dev._ ## Similar posts on daily.dev - [I used VS Code's remote development feature to turn my old laptop into a lightweight coding terminal](https://daily.dev/posts/i-used-vs-code-s-remote-development-feature-to-turn-my-old-laptop-into-a-lightweight-coding-terminal-vo9dy6s2m) · XDA Developers · 2 upvotes · 0 comments - [What's missing from your PHP development environment](https://daily.dev/posts/what-s-missing-from-your-php-development-environment-2wtinewrn) · Laravel News · 1 upvotes · 0 comments - [Develop Faster with VS Code for the Web - Azure Guide](https://daily.dev/posts/develop-faster-with-vs-code-for-the-web---azure-guide-kaqq88b9u) · DevBlogs · 0 upvotes · 0 comments --- Tags: [#devtools](https://daily.dev/tags/devtools), [#nodejs](https://daily.dev/tags/nodejs), [#azure](https://daily.dev/tags/azure) [View this post on daily.dev](https://daily.dev/posts/remote-debugging-of-node-js-apps-on-azure-app-service-from-webstorm-dsarotjfw) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"Remote debugging of Node.js apps on Azure App Service from WebStorm","url":"https://daily.dev/posts/remote-debugging-of-node-js-apps-on-azure-app-service-from-webstorm-dsarotjfw","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/remote-debugging-of-node-js-apps-on-azure-app-service-from-webstorm-dsarotjfw"},"datePublished":"2026-10-04T13:04:10.424Z","dateModified":"2026-10-04T13:05:13.965Z","description":"A step-by-step walkthrough shows how to remote debug Node.js applications running on Azure App Service on Linux using WebStorm. It covers starting the app with...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/e684765d5803fecaf9df74d13c44acc7?_a=AQAEuop","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/e684765d5803fecaf9df74d13c44acc7?_a=AQAEuop","isAccessibleForFree":true,"articleSection":"Maarten Balliauw","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"Maarten Balliauw","logo":"https://media.daily.dev/image/upload/s--rOTg3VYO--/f_auto,q_auto/v1791119043/logos/maartenballiauw?_a=BAMAMicg0","url":"https://daily.dev/sources/maartenballiauw"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/remote-debugging-of-node-js-apps-on-azure-app-service-from-webstorm-dsarotjfw","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"devtools,nodejs,azure","timeRequired":"PT5M"} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Maarten Balliauw","item":"https://daily.dev/sources/maartenballiauw"},{"@type":"ListItem","position":3,"name":"Remote debugging of Node.js apps on Azure App Service from WebStorm"}]} {"@context":"https://schema.org","@type":"FAQPage","@id":"https://daily.dev/posts/remote-debugging-of-node-js-apps-on-azure-app-service-from-webstorm-dsarotjfw#faq","mainEntity":[{"@type":"Question","name":"How do I remote debug a Node.js app running on Azure App Service on Linux from WebStorm?","acceptedAnswer":{"@type":"Answer","text":"Start the app with node's --inspect=0.0.0.0:12345 flag set as the startup command in Azure App Service, then use the Azure CLI command 'az webapp remote-connection create -g RESOURCEGROUP -n WEBAPP -p 3008' to open an SSH tunnel. Forward the debugger port locally with 'ssh -L 12345:127.0.01:12345 root@127.0.0.1 -p 3008', then create a WebStorm Attach to Node.js/Chrome configuration pointing to localhost port 12345. daily.dev surfaces walkthroughs like this for developers wiring up remote debugging across cloud and IDE tooling."}},{"@type":"Question","name":"Why doesn't Node.js remote debugging on Azure App Service on Linux work automatically even though Microsoft said it should just work?","acceptedAnswer":{"@type":"Answer","text":"At the time debugging was still in public preview, and not all Azure regions had the necessary backend support deployed yet. A workaround required manually starting the Node.js process with the --inspect flag as the App Service startup command, since the automatic setup described in Microsoft's announcement did not function in every region. Developers chasing preview-feature quirks across cloud regions track fixes like this on daily.dev."}}]} ```