Node-RED: node nejde nainstalovat kvůli „EBADENGINE“

Cíl: nainstalovat node do Node-RED, když instalace přes Manage palette spadne na EBADENGINE Unsupported engine, protože některá závislost hluboko ve stromu chce novější Node.js, než má image Node-RED.
Předpoklady: přístup do terminálu serveru (SSH nebo terminál v Umbrelu), cesta ke složce /data Node-RED na hostiteli. Uživatelská data včetně nainstalovaných nodů jsou v Dockeru v /data.1

Příznak

npm error code EBADENGINE
npm error notsup Not compatible with your version of node/npm: cookie@2.0.2
npm error notsup Required: {"node":">=22"}
npm error notsup Actual:   {"npm":"10.9.9","node":"v20.20.2"}

Palette instaluje s volbou --engine-strict (je vidět v řádku příkazu na začátku logu instalace). S ní npm balíček s nesedícím polem engines odmítne, bez ní by to bylo jen varování.2

Proč se to děje

Samotný node Node.js 20 podporovat může. Stačí ale jedna nepřímá závislost, která chce Node 22. Ověřený případ node-red-contrib-shelly 11.12.32:

node-red-contrib-shelly (Node ≥ 20) → fastify 5.12 → light-my-request 6.8.x → cookie 2.0.2 (Node ≥ 22)

light-my-request 6.6.0 závisí na cookie 1.x a fastify bere jakoukoli ^6.0.0, takže starší verze mu stačí.2

Postup

  1. Najdi viníka. Z chyby vezmi balíček z řádku Not compatible … <balíček>@<verze> a zjisti, kdo ho tahá a jaká starší verze rodiče Node 20 stačí (npm view <balíček>@<verze> engines, npm view <rodič>@<verze> dependencies). Jde to i v kontejneru Node-RED, npm v něm je:
    sudo docker exec -it <kontejner-node-red> sh -c "cd /tmp && npm view light-my-request@6.6.0 dependencies"
    
  2. Otevři package.json ve složce /data Node-RED (na Umbrelu ~/umbrel/app-data/node-red-standalone/data/package.json):
    nano ~/umbrel/app-data/node-red-standalone/data/package.json
    
  3. Přidej overrides na nejvyšší úroveň souboru (čárkou odděl od sousedního pole). overrides nahradí verzi balíčku kdekoliv ve stromu závislostí.2 Pro Shelly:
    "overrides": {
      "light-my-request": "6.6.0"
    }
    
  4. Nainstaluj node znovu přes Manage palette. Palette instaluje do /data, takže overrides z tohoto package.json použije.

Ověření

Rollback

Troubleshooting

Souvislosti

Zdroje

  1. Node-RED Documentation + release notes ↗ — /data v Dockeru, požadavek Node.js pro Node-RED 5.
  2. npm Docs (package.json overrides, engine-strict) + metadata registru npm ↗ — overrides, engine-strict, metadata balíčků v registru.