Netlify dev errors on WSL 2 when using Windows on ARM

[sbatista-visor]

Describe the bug

I'm using a Snapdragon X Elite based laptop with Windows on ARM and running netlify dev results in the following error:

✖ Setting up the Edge Functions environment. This may take a couple of minutes.
 ›   Warning: Error: Netlify CLI has terminated unexpectedly
 ›   This is a problem with the Netlify CLI, not with your application.
 ›   If you recently updated the CLI, consider reverting to an older version by running:
 ›   
 ›   npm install -g netlify-cli@VERSION
 ›   
 ›   You can use any version from https://ntl.fyi/cli-versions.
 ›   
 ›   Please report this problem at https://ntl.fyi/cli-error including the error details below.
 ›   
 ›       at toError (file:///home/sbatista/WSL_Dev/Visor/agent-newsletter/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected][email protected][email protected]/node_modules/netlify-cli/src/utils/command-helpers.ts:192:39)
 ›       at logError (file:///home/sbatista/WSL_Dev/Visor/agent-newsletter/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected][email protected][email protected]/node_modules/netlify-cli/src/utils/command-helpers.ts:205:15)
 ›       at process.<anonymous> (file:///home/sbatista/WSL_Dev/Visor/agent-newsletter/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected][email protected][email protected]/node_modules/netlify-cli/src/commands/main.ts:83:5)
 ›       at process.emit (node:events:507:28)
 ›       at process._fatalException (node:internal/process/execution:160:25)
 ›       at throwUnhandledRejectionsMode (node:internal/process/promises:394:5)
 ›       at processPromiseRejections (node:internal/process/promises:475:17)
 ›       at processTicksAndRejections (node:internal/process/task_queues:106:32)
Error: There was a problem setting up the Edge Functions environment. To try a manual installation, visit https://ntl.fyi/install-deno.
    at toError (file:///home/sbatista/WSL_Dev/Visor/agent-newsletter/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected][email protected][email protected]/node_modules/netlify-cli/src/utils/command-helpers.ts:192:39)
    at logAndThrowError (file:///home/sbatista/WSL_Dev/Visor/agent-newsletter/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected][email protected][email protected]/node_modules/netlify-cli/src/utils/command-helpers.ts:199:15)
    at prepareServer (file:///home/sbatista/WSL_Dev/Visor/agent-newsletter/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected][email protected][email protected]/node_modules/netlify-cli/src/lib/edge-functions/proxy.ts:265:12)
    at async Promise.all (index 1)
    at file:///home/sbatista/WSL_Dev/Visor/agent-newsletter/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected][email protected][email protected]/node_modules/netlify-cli/src/lib/edge-functions/proxy.ts:145:37
    at onRequest (file:///home/sbatista/WSL_Dev/Visor/agent-newsletter/node_modules/.pnpm/[email protected]_@[email protected]_@[email protected][email protected][email protected]/node_modules/netlify-cli/src/utils/proxy.ts:809:33)

  System:
    OS: Linux 5.15 Ubuntu 22.04.5 LTS 22.04.5 LTS (Jammy Jellyfish)
    CPU: (12) arm64 unknown
  Binaries:
    Node: 24.2.0 - /run/user/1000/fnm_multishells/7574_1752600791387/bin/node
    npm: 11.3.0 - /run/user/1000/fnm_multishells/7574_1752600791387/bin/npm
  npmGlobalPackages:
    netlify-cli: 22.2.2

Steps to reproduce

1. Run netlify dev inside WSL2 using a Windows on ARM machine

Configuration

[build]
  command = "node --run build"
  functions = "netlify/functions"
  publish = "public"

[build.environment]
  NODE_VERSION = "22"

[functions]
  directory = "src/netlify/functions"
  node_bundler = "esbuild"

Environment

System: OS: Linux 5.15 Ubuntu 22.04.5 LTS 22.04.5 LTS (Jammy Jellyfish) CPU: (12) arm64 unknown Memory: 13.80 GB / 15.36 GB Container: Yes Shell: 5.1.16 - /bin/bash Binaries: Node: 24.2.0 - ~/.local/share/fnm/node-versions/v24.2.0/installation/bin/node npm: 11.3.0 - ~/.local/share/fnm/node-versions/v24.2.0/installation/bin/npm pnpm: 10.12.1 - ~/.local/share/fnm/node-versions/v24.2.0/installation/bin/pnpm npmPackages: netlify-cli: ^22.3.0 => 22.3.0 npmGlobalPackages: netlify-cli: 22.2.2

[serhalp]

Hi there! Thank you for submitting this error report.

We've just released v23.9.3 which vastly improves the usefulness of this error message, notably by including some recommended steps for remediation.

Please try upgrading (npm install -g netlify-cli@latest) and let us know if that helps!

If you run into this again and aren't able to self-heal with the printed instructions, please reply with the full output (which will now be a detailed error message that will help us help you way better!). Thanks!