✘ [ERROR] Dependency Installation

[andrmaz]

Environment:

• OS: Windows 11 (Build 26120.6760) with WSL2
• WSL Distribution: Ubuntu 20.04.6 LTS
• Node: 22.13.0
• Npm: 10.9.2
• Git: 2.25.1

Running npm run setup I get the following error:

    ▶️  Starting: Dependency Installation
          Installing third party code dependencies so the workshop works properly on this computer.
          Running the following command: npm install --legacy-peer-deps --no-save
npm error code 1
npm error path /epicai/mcp-ui/exercises/03.complex/01.problem.iframe
npm error command failed
npm error command sh -c npm run pretypecheck
npm error > pretypecheck
npm error > wrangler types ./types/worker-configuration.d.ts && react-router typegen
npm error
npm error
npm error  ⛅️ wrangler 4.40.2 (update available 4.42.0)
npm error ─────────────────────────────────────────────
npm error Generating project types...
npm error
npm error declare namespace Cloudflare {
npm error       interface GlobalProps {
npm error               mainModule: typeof import("../worker/index");
npm error               durableNamespaces: "EpicMeMCP";
npm error       }
npm error       interface Env {
npm error               EPIC_ME_MCP_OBJECT: DurableObjectNamespace<import("../worker/index").EpicMeMCP>;
npm error       }
npm error }
npm error interface Env extends Cloudflare.Env {}
npm error
npm error Generating runtime types...
npm error
npm error
npm error If you think this is a bug then please create an issue at https://github.com/cloudflare/workers-sdk/issues/new/choose
npm error Note that there is a newer version of Wrangler available (4.42.0). Consider checking whether upgrading resolves this error.
npm error ? Would you like to report this error to Cloudflare? Wrangler's output and the error details will be shared with the Wrangler team to help us diagnose and fix the issue.
npm error 🤖 Using fallback value in non-interactive context: no
npm error /epicai/mcp-ui/node_modules/@cloudflare/workerd-linux-64/bin/workerd: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.32' not found (required by /epicai/mcp-ui/node_modules/@cloudflare/workerd-linux-64/bin/workerd)
npm error /epicai/mcp-ui/node_modules/@cloudflare/workerd-linux-64/bin/workerd: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.33' not found (required by /epicai/mcp-ui/node_modules/@cloudflare/workerd-linux-64/bin/workerd)
npm error /epicai/mcp-ui/node_modules/@cloudflare/workerd-linux-64/bin/workerd: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.34' not found (required by /epicai/mcp-ui/node_modules/@cloudflare/workerd-linux-64/bin/workerd)
npm error /epicai/mcp-ui/node_modules/@cloudflare/workerd-linux-64/bin/workerd: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.35' not found (required by /epicai/mcp-ui/node_modules/@cloudflare/workerd-linux-64/bin/workerd)
npm error ✘ [ERROR] write EPIPE
npm error
npm error
npm error 🪵  Logs were written to "/.config/.wrangler/logs/wrangler-2025-10-05_14-33-20_384.log"
npm error npm error Lifecycle script `pretypecheck` failed with error:
npm error npm error code 1
npm error npm error path /epicai/mcp-ui/exercises/03.complex/01.problem.iframe
npm error npm error workspace exercises_03.complex_01.problem.iframe
npm error npm error location /epicai/mcp-ui/exercises/03.complex/01.problem.iframe
npm error npm error command failed
npm error npm error command sh -c wrangler types ./types/worker-configuration.d.ts && react-router typegen
npm error A complete log of this run can be found in: /.npm/_logs/2025-10-05T14_29_54_515Z-debug-0.log
    🚨  Failure: Dependency Installation. Please review the messages above for information on how to troubleshoot and resolve this issue.

Error: write EPIPE
    at afterWriteDispatched (node:internal/stream_base_commons:159:15)
    at writeGeneric (node:internal/stream_base_commons:150:3)
    at Socket._writeGeneric (node:net:971:11)
    at Socket._write (node:net:983:8)
    at writeOrBuffer (node:internal/streams/writable:572:12)
    at _write (node:internal/streams/writable:501:10)
    at Writable.write (node:internal/streams/writable:510:10)
    at Runtime.updateConfig (/epicai/mcp-ui/node_modules/miniflare/dist/src/index.js:49756:26)
    at async #assembleAndUpdateConfig (/epicai/mcp-ui/node_modules/miniflare/dist/src/index.js:61776:30)
    at async Mutex.runWith (/epicai/mcp-ui/node_modules/miniflare/dist/src/index.js:38857:48)

[kentcdodds]

Here's what ChatGPT says:

TL;DR (what to do)

Your WSL distro (Ubuntu 20.04) has glibc 2.31, but the workerd binary that Wrangler/Miniflare pulls now requires glibc ≥ 2.32 (actually asks for 2.32–2.35). That’s the root cause. Upgrade the WSL Linux distro to Ubuntu 22.04 or 24.04 (recommended), then re-run npm run setup.

⸻

Why it broke
• npm run pretypecheck runs wrangler types … && react-router typegen.
• Wrangler/Miniflare pulls a workerd binary compiled against newer glibc.
• Ubuntu 20.04 ships glibc 2.31, so you get:

version GLIBC_2.32' not found … GLIBC_2.33' … GLIBC_2.34' … GLIBC_2.35'

•	Everything downstream (EPIPE, etc.) is fallout from that.

⸻

Fix path A (cleanest): install a fresh Ubuntu 24.04 WSL and use it

This avoids an in-place release upgrade and gets you current glibc.
1. From Windows (PowerShell or Windows Terminal):

wsl --shutdown
wsl --list --verbose
wsl --update
wsl --install -d Ubuntu-24.04

2.	Open the new “Ubuntu-24.04” app, create your user, then verify glibc:

ldd --version # should show 2.39 on 24.04 (or 2.35 on 22.04)

3.	Install basics and Node toolchain (you already have Node on Windows, but keep it inside WSL for consistency):

sudo apt update && sudo apt -y upgrade
sudo apt -y install build-essential git

4.	In the new distro, clone/move your repo, then:

node -v # 22.13.0 is fine
npm -v # 10.9.2 is fine
npm run setup

Tip: If you want to migrate your existing 20.04 home directory:
• From Windows:

wsl --shutdown
wsl --export C:\temp\ubuntu20.tar

Then mount/import pieces into the new distro or just copy the project folder from Windows via File Explorer (\wsl.localhost\Ubuntu-20.04\home<you>...) to \wsl.localhost\Ubuntu-24.04\home<you>....

⸻

Fix path B (in-place upgrade): bump your current WSL from 20.04 → 22.04 (or 24.04)

This is fine if you don’t want a new distro.
1. Inside your existing Ubuntu-20.04:

sudo apt update && sudo apt -y full-upgrade
sudo do-release-upgrade # go to 22.04 (Jammy)

If it says “No new release found”, add:

sudo sed -i 's/Prompt=lts/Prompt=normal/' /etc/update-manager/release-upgrades

then rerun do-release-upgrade

(Optional) From 22.04 to 24.04:

sudo apt update && sudo apt -y full-upgrade
sudo do-release-upgrade

2.	Restart WSL:

wsl --shutdown

Reopen the distro and verify:

lsb_release -a
ldd --version # 2.35 on 22.04; 2.39 on 24.04

3.	Re-run:

npm ci || npm install --legacy-peer-deps --no-save
npm run setup

⸻

Alternatives if you can’t upgrade the distro (short-term hacks)
• Run on Windows-native (outside WSL) with a recent Node and Wrangler; Cloudflare provides Windows builds of workerd. This sidesteps the Linux glibc constraint.
• Containerize: run the setup inside a devcontainer or Docker image based on Ubuntu 22.04/24.04 (or Debian bookworm) so glibc is new enough.
• Pin an older toolchain: find a Wrangler/Miniflare/workerd version that still supports glibc 2.31. This is brittle, time-consuming, and I don’t recommend it unless you need a stopgap.

⸻

Sanity checks after upgrading

wrangler --version # should work without glibc errors
which workerd # optional: confirm it resolves
node -v && npm -v
ldd --version

Then:

npm cache verify
rm -rf node_modules package-lock.json
npm install --legacy-peer-deps --no-save
npm run setup

⸻

Why upgrading is the right call
• Cloudflare’s workerd aggressively tracks modern glibc (and Debian/Ubuntu releases). Staying on 20.04 will keep breaking as more deps assume ≥2.32.
• 22.04 (glibc 2.35) or 24.04 (2.39) future-proofs this class of errors across many modern tools.

If you want, I can script the export/import of your project into a fresh Ubuntu-24.04 WSL instance, but the steps above should get you unblocked fast.