From c2b328d84178a0fcfb9fa9ab4b3156813d72e62d Mon Sep 17 00:00:00 2001 From: germondai Date: Wed, 1 Jul 2026 19:04:43 +0200 Subject: [PATCH] docs: mention bun kernel version requirements for :baseline vs :latest --- README.md | 2 +- apps/docs/deployment/standalone.md | 2 ++ apps/web/app/components/CtaSection.vue | 4 ++-- 3 files changed, 5 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 215d4c1..aa5efb0 100644 --- a/README.md +++ b/README.md @@ -111,7 +111,7 @@ image: ghcr.io/germondai/trawl:latest image: ghcr.io/germondai/trawl:baseline ``` -Synology note: many Synology NAS units (DSM 7.x on J4125 / older hardware) ship kernel 4.4.x, which Bun's modern runtime can't fully handle. The `:baseline` tag is published for that case — **confirmed working** on a Synology DS920+ (Celeron J4125, DSM 7.3.2, kernel 4.4.302): the container starts cleanly, `/health` reports healthy, and it solves live Cloudflare challenges via `/v1` (see [#1](https://github.com/germondai/trawl/issues/1)). Published by independent GitHub Actions workflows (`.github/workflows/publish.yml`, `publish-baseline.yml`); tag-triggered releases push matching git tags (e.g. `v1.0.0` → `1.0.0`, `1.0.0-baseline` → `1.0.0-baseline`) and manual `workflow_dispatch` from `main` updates the rolling tag (`latest` and `baseline` respectively). +Synology note: many Synology NAS units (DSM 7.x on J4125 / older hardware) ship kernel 4.4.x, which Bun's modern runtime can't fully handle. Standard Bun requires kernel 5.1+ (5.6+ recommended); the baseline build degrades gracefully down to kernel 3.10. The `:baseline` tag is published for that case — **confirmed working** on a Synology DS920+ (Celeron J4125, DSM 7.3.2, kernel 4.4.302): the container starts cleanly, `/health` reports healthy, and it solves live Cloudflare challenges via `/v1` (see [#1](https://github.com/germondai/trawl/issues/1)). Published by independent GitHub Actions workflows (`.github/workflows/publish.yml`, `publish-baseline.yml`); tag-triggered releases push matching git tags (e.g. `v1.0.0` → `1.0.0`, `1.0.0-baseline` → `1.0.0-baseline`) and manual `workflow_dispatch` from `main` updates the rolling tag (`latest` and `baseline` respectively). ## Configuration diff --git a/apps/docs/deployment/standalone.md b/apps/docs/deployment/standalone.md index 0822990..bbeb9ca 100644 --- a/apps/docs/deployment/standalone.md +++ b/apps/docs/deployment/standalone.md @@ -36,6 +36,8 @@ docker run -d \ If your host CPU doesn't support AVX2 — older Synology NAS units, Atom/Celeron-era hardware, pre-2013 x86_64 — use the `:baseline` tag instead. Same image, same commands, built on Bun's baseline runtime. +Standard Bun requires Linux kernel 5.1+ (5.6+ recommended); the baseline build degrades gracefully on kernels as old as 3.10 (RHEL 7-era) — covering most Synology DSM installs out of the box. + ```bash # Pull docker pull ghcr.io/germondai/trawl:baseline diff --git a/apps/web/app/components/CtaSection.vue b/apps/web/app/components/CtaSection.vue index 5599ac6..4c5e070 100644 --- a/apps/web/app/components/CtaSection.vue +++ b/apps/web/app/components/CtaSection.vue @@ -123,8 +123,8 @@ const tabs: { id: Tab; label: string; hint: string }[] = [

- Older hardware or a Synology NAS without AVX2? Swap :latest for - :baseline in the image tag above — + Older hardware or a Synology NAS without AVX2 / kernel < 5.1? Swap :latest for + :baseline in the image tag above — degrades gracefully down to kernel 3.10 — same commands, different runtime.