Karakeep: Version 0.27.0 breaks the workers #1596

Closed
opened 2026-02-05 01:43:01 +03:00 by OVERLORD · 6 comments
Owner

Originally created by @MohamedBassem on GitHub (Sep 7, 2025).

Originally assigned to: @CrazyWolf13 on GitHub.

Have you read and understood the above guidelines?

yes

📜 What is the name of the script you are using?

Karakeep

📂 What was the exact command used to execute the script?

..

⚙️ What settings are you using?

  • Default Settings
  • Advanced Settings

🖥️ Which Linux distribution are you using?

No response

📈 Which Proxmox version are you on?

8.4.6

📝 Provide a clear and concise description of the issue.

Opening this issue preemptively in before people open it here. I noticed it just after releasing the new version unfortunately.

In the last release of karakeep, the worker build path changed from index.mjs to index.js which will require updating the systemd configs for those apps.

🔄 Steps to reproduce the issue.

Upgrading (or installing) karakeep to version 0.27 will break the

Paste the full error output (if available).

Node.js v22.19.0
node:internal/modules/cjs/loader:1386
  throw err;
  ^

Error: Cannot find module '/opt/karakeep/apps/workers/dist/index.js'
    at Function._resolveFilename (node:internal/modules/cjs/loader:1383:15)
    at defaultResolveImpl (node:internal/modules/cjs/loader:1025:19)
    at resolveForCJSWithHooks (node:internal/modules/cjs/loader:1030:22)
    at Function._load (node:internal/modules/cjs/loader:1192:37)
    at TracingChannel.traceSync (node:diagnostics_channel:322:14)
    at wrapModuleLoad (node:internal/modules/cjs/loader:237:24)
    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:171:5)
    at node:internal/main/run_main_module:36:49 {
  code: 'MODULE_NOT_FOUND',
  requireStack: []
}

🖼️ Additional context (optional).

No response

Originally created by @MohamedBassem on GitHub (Sep 7, 2025). Originally assigned to: @CrazyWolf13 on GitHub. ### ✅ Have you read and understood the above guidelines? yes ### 📜 What is the name of the script you are using? Karakeep ### 📂 What was the exact command used to execute the script? .. ### ⚙️ What settings are you using? - [x] Default Settings - [ ] Advanced Settings ### 🖥️ Which Linux distribution are you using? _No response_ ### 📈 Which Proxmox version are you on? 8.4.6 ### 📝 Provide a clear and concise description of the issue. Opening this issue preemptively in before people open it here. I noticed it just after releasing the new version unfortunately. In the last release of karakeep, the worker build path changed from `index.mjs` to `index.js` which will require updating the systemd configs for those apps. ### 🔄 Steps to reproduce the issue. Upgrading (or installing) karakeep to version 0.27 will break the ### ❌ Paste the full error output (if available). ``` Node.js v22.19.0 node:internal/modules/cjs/loader:1386 throw err; ^ Error: Cannot find module '/opt/karakeep/apps/workers/dist/index.js' at Function._resolveFilename (node:internal/modules/cjs/loader:1383:15) at defaultResolveImpl (node:internal/modules/cjs/loader:1025:19) at resolveForCJSWithHooks (node:internal/modules/cjs/loader:1030:22) at Function._load (node:internal/modules/cjs/loader:1192:37) at TracingChannel.traceSync (node:diagnostics_channel:322:14) at wrapModuleLoad (node:internal/modules/cjs/loader:237:24) at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:171:5) at node:internal/main/run_main_module:36:49 { code: 'MODULE_NOT_FOUND', requireStack: [] } ``` ### 🖼️ Additional context (optional). _No response_
OVERLORD added the bug label 2026-02-05 01:43:01 +03:00
Author
Owner

@MohamedBassem commented on GitHub (Sep 7, 2025):

And maybe in the context of this issue, we need to discuss how to bundle the installation script with every karakeep release so that it's versioned controlled along each release.

@MohamedBassem commented on GitHub (Sep 7, 2025): And maybe in the context of this issue, we need to discuss how to bundle the installation script with every karakeep release so that it's versioned controlled along each release.
Author
Owner

@MickLesk commented on GitHub (Sep 7, 2025):

Maybe it would be a possibility to deliver a complete prebuild (gh Action - many use this now, paperless and co.), or an NPM installation? (Example actualBudget).

Update the Service should not be an problem, this are 2-3 lines more Code.

@MickLesk commented on GitHub (Sep 7, 2025): Maybe it would be a possibility to deliver a complete prebuild (gh Action - many use this now, paperless and co.), or an NPM installation? (Example actualBudget). Update the Service should not be an problem, this are 2-3 lines more Code.
Author
Owner

@MohamedBassem commented on GitHub (Sep 7, 2025):

Yeah, I think an NPM installation will probably be the way to go instead of a full build on every installation. Will try to look into that in the next release.

For now, we'll need a migration to migrate:

ExecStart=/usr/bin/node dist/index.mjs

to

ExecStart=/usr/bin/node dist/index.js

Really sorry about the hassle.

@MohamedBassem commented on GitHub (Sep 7, 2025): Yeah, I think an NPM installation will probably be the way to go instead of a full build on every installation. Will try to look into that in the next release. For now, we'll need a migration to migrate: ``` ExecStart=/usr/bin/node dist/index.mjs ``` to ``` ExecStart=/usr/bin/node dist/index.js ``` Really sorry about the hassle.
Author
Owner

@michelroegl-brunner commented on GitHub (Sep 7, 2025):

Yeah, I think an NPM installation will probably be the way to go instead of a full build on every installation. Will try to look into that in the next release.

For now, we'll need a migration to migrate:

ExecStart=/usr/bin/node dist/index.mjs

to

ExecStart=/usr/bin/node dist/index.js

Really sorry about the hassle.

No worries, this is no big deal.
But i really apprechiate the heads up from you on this issue, we dont see that normaly :)

@michelroegl-brunner commented on GitHub (Sep 7, 2025): > Yeah, I think an NPM installation will probably be the way to go instead of a full build on every installation. Will try to look into that in the next release. > > For now, we'll need a migration to migrate: > > ``` > ExecStart=/usr/bin/node dist/index.mjs > ``` > to > ``` > ExecStart=/usr/bin/node dist/index.js > ``` > > Really sorry about the hassle. No worries, this is no big deal. But i really apprechiate the heads up from you on this issue, we dont see that normaly :)
Author
Owner

@michelroegl-brunner commented on GitHub (Sep 7, 2025):

And thanks to @CrazyWolf13 the fix is allready merged.

@michelroegl-brunner commented on GitHub (Sep 7, 2025): And thanks to @CrazyWolf13 the fix is allready merged.
Author
Owner

@MohamedBassem commented on GitHub (Sep 7, 2025):

The perks of having a user in the community-scripts team! ❤️ Really appreciate all the help @CrazyWolf13!

@MohamedBassem commented on GitHub (Sep 7, 2025): The perks of having a user in the community-scripts team! ❤️ Really appreciate all the help @CrazyWolf13!
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/ProxmoxVE#1596