From 0ed31ab0def7e96e63b05b7f8c30beb004343f9d Mon Sep 17 00:00:00 2001 From: salmonumbrella <182032677+salmonumbrella@users.noreply.github.com> Date: Fri, 17 Jul 2026 15:07:57 -0700 Subject: [PATCH] chore: document Node 22 requirement Co-Authored-By: Claude Fable 5 --- .nvmrc | 1 + README.md | 6 +++--- backend/package.json | 3 +++ 3 files changed, 7 insertions(+), 3 deletions(-) create mode 100644 .nvmrc diff --git a/.nvmrc b/.nvmrc new file mode 100644 index 0000000..2bd5a0a --- /dev/null +++ b/.nvmrc @@ -0,0 +1 @@ +22 diff --git a/README.md b/README.md index 0f5c1c0..af84a25 100644 --- a/README.md +++ b/README.md @@ -252,7 +252,7 @@ No container runtime required. The steps below use Ubuntu/Debian; adapt package ### Prerequisites -- **Node.js 20+** — [nodejs.org](https://nodejs.org) or via your package manager +- **Node.js 22 (LTS)** — [nodejs.org](https://nodejs.org) or via your package manager. Newer majors break the backend: Node's built-in `fetch` conflicts with the pinned `undici` dispatcher. - **PostgreSQL 16+** - **Redis 7+** - **nginx** — serves the built frontend and proxies API/WebSocket requests to the backend @@ -261,8 +261,8 @@ No container runtime required. The steps below use Ubuntu/Debian; adapt package **Ubuntu / Debian:** ```bash -# Node.js 20 via NodeSource -curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - +# Node.js 22 via NodeSource +curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs postgresql redis-server nginx ``` diff --git a/backend/package.json b/backend/package.json index 5864a14..f4c8a13 100644 --- a/backend/package.json +++ b/backend/package.json @@ -2,6 +2,9 @@ "name": "mailflow-backend", "version": "2.6.0", "type": "module", + "engines": { + "node": ">=22 <23" + }, "scripts": { "start": "node src/index.js", "dev": "node --watch src/index.js",