App stopped responding after updating package to v4.24.0

[james]

Hello @dev-cb
Is there any log from the N8N app when starting up why it fails?

[dev-cb]

Sorry, was cut. Yes..

...
2026-05-27T07:59:20.000Z => Healthcheck error: Error: connect ECONNREFUSED 10.254.87.41: 8080
2026-05-27T07:59:30.000Z => Healthcheck error: Error: connect ECONNREFUSED 10.254.87.41: 8080
2026-05-27T07:59:35+02:00 ==> Ensure directories
2026-05-27T07:59:35+02:00 ==> Setting permissions
2026-05-27T07:59:35+02:00 ==> Starting N8N
2026-05-27T07:59:37+02:00 Error: ENOENT: no such file or directory, open '/app/data/user/.n8n/nodes/node_modules/n8n-nodes-xlsx/package.json'
2026-05-27T07:59:37+02:00 at /app/code/node_modules/.pnpm/n8n-core@file+packages+core_@opentelemetry+api@1.9.0_@opentelemetry+exporter-trace-otlp_<HASH_REDACTED>/node_modules/n8n-core/src/nodes-loader/scan-directory-for-packages.ts:29:4
2026-05-27T07:59:37+02:00 at Array.map (<anonymous>)
2026-05-27T07:59:37+02:00 at CommandRegistry.execute (/app/code/src/command-registry.ts:46:3)
2026-05-27T07:59:37+02:00 at CommunityPackagesModule.nodeLoaders (/app/code/src/modules/community-packages/community-packages.module.ts:41:10)
2026-05-27T07:59:37+02:00 at LazyPackageDirectoryLoader.readJSONSync (/app/code/node_modules/.pnpm/n8n-core@file+packages+core_@opentelemetry+api@1.9.0_@opentelemetry+exporter-trace-otlp_<HASH_REDACTED>/node_modules/n8n-core/src/nodes-loader/package-directory-loader.ts:96:34)
2026-05-27T07:59:37+02:00 at ModuleRegistry.loadModules (/app/code/node_modules/.pnpm/@n8n+backend-common@file+packages+@n8n+backend-common_zod@3.25.67/node_modules/@n8n/backend-common/src/modules/module-registry.ts:124:20)
2026-05-27T07:59:37+02:00 at new LazyPackageDirectoryLoader (/app/code/node_modules/.pnpm/n8n-core@file+packages+core_@opentelemetry+api@1.9.0_@opentelemetry+exporter-trace-otlp_<HASH_REDACTED>/node_modules/n8n-core/src/nodes-loader/lazy-package-directory-loader.ts:6:1)
2026-05-27T07:59:37+02:00 at new PackageDirectoryLoader (/app/code/node_modules/.pnpm/n8n-core@file+packages+core_@opentelemetry+api@1.9.0_@opentelemetry+exporter-trace-otlp_<HASH_REDACTED>/node_modules/n8n-core/src/nodes-loader/package-directory-loader.ts:20:27)
2026-05-27T07:59:37+02:00 at readFileSync (node:fs:439:20)
2026-05-27T07:59:37+02:00 at scanDirectoryForPackages (/app/code/node_modules/.pnpm/n8n-core@file+packages+core_@opentelemetry+api@1.9.0_@opentelemetry+exporter-trace-otlp_<HASH_REDACTED>/node_modules/n8n-core/src/nodes-loader/scan-directory-for-packages.ts:27:31)
2026-05-27T07:59:40.000Z => Healthcheck error: Error: connect ECONNREFUSED 10.254.87.41: 8080
2026-05-27T07:59:50.000Z => Healthcheck error: Error: connect ECONNREFUSED 10.254.87.41: 8080

So it looks indeed like n8n attempts to load a package but can not find the required package.json so it exits.

[dev-cb]

/app/data/user/.n8n/nodes/node_modules/n8n-nodes-xlsx/ is indeed empty. Was created a few days ago, which differs from the other node packages.

[ChrisHvd]

I have the exact same issue since yesterday. The migration to 4.24.0 crashes the server.

[dev-cb]

I removed the empty directory /app/data/user/.n8n/nodes/node_modules/n8n-nodes-xlsx/ and restarted.
At first the app was not responding, then was running.

@chrishvd Could you please check if the same behaviour matches your issue?

[james]

Hello @dev-cb
Where did n8n-nodes-xlsx come from, with your statement:

@dev-cb said:

/app/data/user/.n8n/nodes/node_modules/n8n-nodes-xlsx/

This was not in the log you posted above, so how did you figure out it was this folder?

edit:
I see, the log was cut off again.

[dev-cb]

@james said:

Hello @dev-cb
Where did n8n-nodes-xlsx come from, with your statement:

@dev-cb said:

/app/data/user/.n8n/nodes/node_modules/n8n-nodes-xlsx/

This was not in the log you posted above, so how did you figure out it was this folder?

Copied the wrong event. My bad... Sorry for sloppiness.
I’ve adjusted the post with the log.

[luckow]

@dev-cb I had the same issue with an empty Zabbix folder. Restoring the old version, deleting the empty folder, and updating to the latest version worked. But I thought it had nothing to do with the app package and was just an issue with my instance.

[dev-cb]

@luckow said:

@dev-cb I had the same issue with an empty Zabbix folder. Restoring the old version, deleting the empty folder, and updating to the latest version worked. But I thought it had nothing to do with the app package and was just an issue with my instance.

Yes. Just did the same, backup, update, restart went all though.

[james]

I have looked into this issue.

#1 Our EXTRA_NODE_MODULES (for the Code node) installed in start.sh:47-50 into /run/n8n/custom-node-modules/, which is ephemeral (/run/...) and reinstalled on every boot, then symlinked to /app/node_modules (Dockerfile:40).

#2 n8n Community Nodes (n8n-nodes-*, installed through the web UI), n8n puts these under $N8N_USER_FOLDER/.n8n/nodes/, i.e. /app/data/user/.n8n/nodes/. That's persistent (under /app/data). It keeps a package.json listing the installed community packages plus the actual code in nodes/node_modules/, and also tracks them in the DB.

The failing path is /app/data/user/.n8n/nodes/node_modules/n8n-nodes-xlsx/package.json, that's path #2. n8n-nodes-xlsx is a community node the user installed via the UI. The crash (scanDirectoryForPackages → CommunityPackagesModule.nodeLoaders) happens because the nodes/package.json still lists n8n-nodes-xlsx but the actual node_modules/n8n-nodes-xlsx/ directory is missing/incomplete, an orphaned reference. n8n's startup scan is not tolerant of this and throws.

Typical cause: a community-node install/uninstall that was interrupted or partially failed (npm wrote the package.json entry, but the module folder wasn't fully written), or the directory got out of sync across a restart/upgrade. It's a n8n-side robustness issue, not our packaging.

We could add a handler in our start.sh to prevent this issue.
I will look into that.

[ChrisHvd]

@dev-cb I cannot update my instance and try as prod workflows are running. But I have another instance which migrated to 2.24.0 without any trouble. The only difference between the two is the presence of NODE_FUNCTION_ALLOW_BUILTIN=* on the first one (the one that crashes).

[james]

Hello @chrishvd
Please check the start log when you have updated N8N and send that log.
If the log includes lines like the above issue from a n8n community node, you can fix the issue like mentioned by @dev-cb

[ChrisHvd]

The only thing I can found is slightly different from yours, although it touches some n8n node package I don't know.

*2026-05-26T00:01:05Z ⠼==> Starting N8N
2026-05-26T00:01:08Z Last session crashed
2026-05-26T00:01:10.000Z => Healthcheck error: Error: connect ECONNREFUSED 172.18.17.212:5678
2026-05-26T00:01:18Z 
2026-05-26T00:01:18Z 
2026-05-26T00:01:18Z Node loader n8n-nodes-base is already registered.
2026-05-26T00:01:18Z Error: Node loader n8n-nodes-base is already registered.
2026-05-26T00:01:18Z Error: Node loader n8n-nodes-base is already registered.
2026-05-26T00:01:18Z Error: Exiting due to an error.*

[james]

Hello @chrishvd
This looks indeed different.
And there is no log after texiting due to an error?