Ubuntu/Debian server process hangs and causes new port after workshop update

[isimmons]

Reported on the Discord by me on Ubuntu and @dawnmist on Debian.

When using the 'u' option to update the server restarts but on a different port because the default port is still in use.

I did some testing and it seems the issue might not actually be the update process.

As you can see below, if I manually stop the server with ctrl+c and then check, there are two processes still using port 5639.

➜  advanced-mcp-features git:(main) sudo sudo lsof -t -i:5639 
[sudo] password for isimmons: 
104962
105243
➜  advanced-mcp-features git:(main) sudo kill -9 $(sudo lsof -t -i:5639)
➜  advanced-mcp-features git:(main) sudo sudo lsof -t -i:5639           
➜  advanced-mcp-features git:(main) npm run start

> start
> npx --prefix ./epicshop epicshop start

🐨 Welcome to the workshop, isimmons!
Supported keys:
  o - open workshop app
  u - update workshop
  r - restart workshop app
  k - Kody kudos 🐨
  q - exit (or Ctrl+C)

🐨  Let's get learning!
Local:            http://localhost:5639
On Your Network:  http://192.168.86.248:5639

➜  advanced-mcp-features git:(main) sudo sudo lsof -t -i:5639
122023
122409
➜  advanced-mcp-features git:(main) 

I also tried killing the processes, restarting the server (uses correct port 5639) and then open a new terminal tab and see two processes are running.

➜  advanced-mcp-features git:(main) sudo sudo lsof -t -i:5639
[sudo] password for isimmons: 
125342
125751
➜  advanced-mcp-features git:(main) 

Tested on both node v 23.11.1 and node v 24.4.1 and got the same results.

[dawnmist]

Server output during updating:

🔄 Update requested from web UI. Running update and restarting app process...

👀 Checking for updates...
⬇️ Pulling latest changes...
📦 Re-installing dependencies...

> postinstall
> cd ./epicshop && npm install


up to date, audited 1015 packages in 778ms

280 packages are looking for funding
  run `npm fund` for details

found 0 vulnerabilities

added 66 packages, and audited 607 packages in 2s

165 packages are looking for funding
  run `npm fund` for details

found 0 vulnerabilities
🧹 Cleaning up empty exercise directories...
   No empty directories found.
✅ Updated successfully.

🔄 Restarting...
⚠️  Port 5639 is not available, using 5640 instead.
🐨  Let's get learning!
Local:            http://localhost:5640
On Your Network:  http://192.168.1.82:5640


🔄 Update requested from web UI. Running update and restarting app process...

👀 Checking for updates...
✅ No updates available.

🔄 Restarting...
⚠️  Port 5639 is not available, using 5641 instead.
🐨  Let's get learning!
Local:            http://localhost:5641
On Your Network:  http://192.168.1.82:5641

Running seed script...
(node:2796465) ExperimentalWarning: SQLite is an experimental feature and might change at any time
(Use `node --trace-warnings ...` to show where the warning was created)
Starting migration process...
Current schema version: 0
Running migration 1: initial_schema
Starting initial schema migration...
Successfully created all tables
Completed migration 1
Migration process completed successfully
Seed complete!
Seed script completed successfully

🔄 Update requested from terminal. Running update and restarting app process...

👀 Checking for updates...
✅ No updates available.

🔄 Restarting...
⚠️  Port 5639 is not available, using 5642 instead.
🐨  Let's get learning!
Local:            http://localhost:5642
On Your Network:  http://192.168.1.82:5642

Note in the above:

• initial update in the UI
• second UI prompt due to the restart of the client after the first update, but as the url had changed for the new app and the previous app was still running on the original port, the second update prompt was actually due to the wrong app being accessed (pre-update app).
• check on the command line for whether there really was still an update to be applied

Process list (ps auxww | grep node | grep start.js) fills up with multiple server applications, that need to be manually killed even after quitting the primary app. They need to be killed manually.

node --import=file:///home/username/src/epicweb-dev/advanced-mcp-features/epicshop/node_modules/@epic-web/workshop-app/instrument.js ./start.js

Running node v24.2.0

[kentcdodds]

Pretty sure I got it. Will update the workshop once this is released in a few minutes.

[kentcdodds]

Could you go into the epicshop directory and update your versions to:

    "@epic-web/workshop-app": "6.13.0",
    "@epic-web/workshop-cli": "6.13.0",
    "@epic-web/workshop-utils": "6.13.0",

(without the ^).

The next version after that one is when I made a significant change to the CLI, and I just want to see if that change to the CLI is the reason you're having these problems.

Hit r to restart and let me know if that's causing this issue before/after you install this older version.

[dawnmist]

I set the epicshop/package.json to have those dependency versions, then ran npm run setup.

Setup failed with the error message:

$> npm run setup

> setup
> node ./epicshop/setup.js

▶️  Starting workshop setup...
      Running the following command: npx --yes "https://gist.github.com/kentcdodds/bb452ffe53a5caa3600197e1d8005733" -q
    ▶️  Starting: System Validation
          Ensuring the correct versions of tools are installed on this computer.
          Running the following command: npx --yes "https://gist.github.com/kentcdodds/abbc32701f78fa70298d444c2303b6d9"
    ✅  Success: System Validation


    ▶️  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

> postinstall
> cd ./epicshop && npm install


changed 4 packages, and audited 1015 packages in 19s

280 packages are looking for funding
  run `npm fund` for details

found 0 vulnerabilities

up to date, audited 607 packages in 20s

165 packages are looking for funding
  run `npm fund` for details

found 0 vulnerabilities
    ✅  Success: Dependency Installation


    ▶️  Starting: Custom Setup
          Handling custom setup (if neccessary)
          Running the following command: npm run setup:custom --if-present

> setup:custom
> node ./epicshop/setup-custom.js

node:internal/modules/esm/resolve:313
  return new ERR_PACKAGE_PATH_NOT_EXPORTED(
         ^

Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: Package subpath './warm' is not defined by "exports" in /home/username/src/epicweb-dev/advanced-mcp-features/epicshop/node_modules/@epic-web/workshop-cli/package.json imported from /home/username/src/epicweb-dev/advanced-mcp-features/epicshop/setup-custom.js
    at exportsNotFound (node:internal/modules/esm/resolve:313:10)
    at packageExportsResolve (node:internal/modules/esm/resolve:660:9)
    at packageResolve (node:internal/modules/esm/resolve:773:12)
    at moduleResolve (node:internal/modules/esm/resolve:853:18)
    at defaultResolve (node:internal/modules/esm/resolve:983:11)
    at ModuleLoader.defaultResolve (node:internal/modules/esm/loader:801:12)
    at #cachedDefaultResolve (node:internal/modules/esm/loader:725:25)
    at ModuleLoader.resolve (node:internal/modules/esm/loader:708:38)
    at ModuleLoader.getModuleJobForImport (node:internal/modules/esm/loader:309:38)
    at #link (node:internal/modules/esm/module_job:201:49) {
  code: 'ERR_PACKAGE_PATH_NOT_EXPORTED'
}

Node.js v24.2.0
    🚨  Failure: Custom Setup. Please review the messages above for information on how to troubleshoot and resolve this issue.

[isimmons]

I changed the package.json, did npm install inside epicshop then back in the dev server did "r" and got the following.

🔄 Restarting app process...
node:internal/modules/esm/resolve:274
    throw new ERR_MODULE_NOT_FOUND(
          ^

Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/home/isimmons/code/Epic/MCP/advanced-mcp-features/epicshop/node_modules/@epic-web/workshop-app/instrument.js' imported from /home/isimmons/code/Epic/MCP/advanced-mcp-features/epicshop/node_modules/@epic-web/workshop-app/
    at finalizeResolution (node:internal/modules/esm/resolve:274:11)
    at moduleResolve (node:internal/modules/esm/resolve:859:10)
    at defaultResolve (node:internal/modules/esm/resolve:983:11)
    at ModuleLoader.defaultResolve (node:internal/modules/esm/loader:801:12)
    at #cachedDefaultResolve (node:internal/modules/esm/loader:725:25)
    at ModuleLoader.resolve (node:internal/modules/esm/loader:708:38)
    at ModuleLoader.getModuleJobForImport (node:internal/modules/esm/loader:309:38)
    at onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:659:36)
    at TracingChannel.tracePromise (node:diagnostics_channel:344:14)
    at ModuleLoader.import (node:internal/modules/esm/loader:658:21) {
  code: 'ERR_MODULE_NOT_FOUND',
  url: 'file:///home/isimmons/code/Epic/MCP/advanced-mcp-features/epicshop/node_modules/@epic-web/workshop-app/instrument.js'
}

Node.js v24.4.1

[kentcdodds]

Rats. Could you try 6.10.0?

[isimmons]

Am I doing this right?

New terminal tab
cd into epicshop and change the versions to "6.10.0"
npm install

Go back to the workshop tab and restart.

Different module not found this time.

🔄 Restarting app process...
node:internal/modules/esm/resolve:274
    throw new ERR_MODULE_NOT_FOUND(
          ^

Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/home/isimmons/code/Epic/MCP/advanced-mcp-features/epicshop/node_modules/@epic-web/workshop-app/instrument.js' imported from /home/isimmons/code/Epic/MCP/advanced-mcp-features/epicshop/node_modules/@epic-web/workshop-app/
    at finalizeResolution (node:internal/modules/esm/resolve:274:11)
    at moduleResolve (node:internal/modules/esm/resolve:859:10)
    at defaultResolve (node:internal/modules/esm/resolve:983:11)
    at ModuleLoader.defaultResolve (node:internal/modules/esm/loader:801:12)
    at #cachedDefaultResolve (node:internal/modules/esm/loader:725:25)
    at ModuleLoader.resolve (node:internal/modules/esm/loader:708:38)
    at ModuleLoader.getModuleJobForImport (node:internal/modules/esm/loader:309:38)
    at onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:659:36)
    at TracingChannel.tracePromise (node:diagnostics_channel:344:14)
    at ModuleLoader.import (node:internal/modules/esm/loader:658:21) {
  code: 'ERR_MODULE_NOT_FOUND',
  url: 'file:///home/isimmons/code/Epic/MCP/advanced-mcp-features/epicshop/node_modules/@epic-web/workshop-app/instrument.js'
}

Node.js v24.4.1

[kentcdodds]

That is a big surprise... You're stopping and restarting after install right?

[kentcdodds]

Whoops, no you're good. Let's try 6.3.0. Sorry 😅

[isimmons]

Actually after I killed it and started it again, on 6.10.0 it is running but still have the same issue.

[onemen]

try to remove advanced-mcp-features and do a clean clone, maybe its a cache issue