Zen crashes at startup with Cannot find module node:async_hooks; upgrade to Node 16+

TL;DR: Fix: run on Node 16 or newer (a maintainer verified The node:

Zen crashes at startup with Cannot find module node:async_hooks; upgrade to Node 16+

Fix

1. Fix: run on Node 16 or newer (a maintainer verified. Expected: this specific failure stops.

Details

The node: module prefix requires Node 14.18+ (and Zen targets Node 16+). The reporter was on an old Node where node:async_hooks did not exist, so the firewall's context storage module failed at require time. node:16-alpine in Docker works). If you see Cannot find module 'node:...' from any instrumenting library, your Node is too old for the node: prefix, upgrade Node before debugging anything else.

When to use

You hit exactly this: Zen crashes at startup with Cannot find module node:async_hooks; upgrade to Node 16+ in Zen.

When not to use

A different error, or the same symptom in a different tool. This page only covers the failure above.

Compatibility

Zen (versions mentioned here: 14.18).

Asked in GitHub issue gh:AikidoSec/firewall-node#272: Issue AikidoSec/firewall-node#272 (closed, 4 comments): adding require('@aikidosec/firewall') as the first line crashed the app at startup with Error: Cannot find module 'node:async_hooks'. The verified fix/answer: The node: module prefix requires Node 14.18+ (and Zen targets Node 16+). The reporter was on an old Node where node:async_hooks did not exist, so the firewall's context storage module failed at require time. Fix: run on Node 16 or newer (a maintainer verified node:16-alpine in Docker works). If you see Cannot find module 'node:...' from any instrumenting library, your Node is too old for the node: prefix, upgrade Node before debugging anything else. Source: https://github.com/AikidoSec/firewall-node/issues/272