Skip to content

Commit d9939e6

Browse files
committed
docs: add Ubuntu 22.04 workaround (pin uWebSockets.js v20.52.0) to glibc note
1 parent 6d32ba9 commit d9939e6

1 file changed

Lines changed: 9 additions & 0 deletions

File tree

docs/providers/install/manual_install.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,15 @@ installation, this is the way to go.
3333
- Upgrade the host to Ubuntu 24.04+ (glibc ≥ 2.38) — recommended.
3434
- Run Hyperion in a container with a glibc ≥ 2.38 base image
3535
(e.g. `node:22-trixie-slim` / Debian 13, or an Ubuntu 24.04 base).
36+
- **Stay on Ubuntu 22.04** by pinning the last glibc-2.35-compatible
37+
build, [`uWebSockets.js` v20.52.0](https://github.com/uNetworking/uWebSockets.js/releases/tag/v20.52.0).
38+
After every build / `npm ci` (which restores the pinned v20.67.0),
39+
force-install it again:
40+
```bash
41+
npm install --no-save github:uNetworking/uWebSockets.js#v20.52.0
42+
```
43+
Trades newer `uWebSockets.js` fixes for compatibility; must be
44+
re-applied after each rebuild.
3645
- Build `uWebSockets.js` from source on the target host against its
3746
local glibc (unsupported by upstream, but the documented escape hatch:
3847
*"you can always build your own binaries on older Linux systems"*).

0 commit comments

Comments
 (0)