docs: mention bun kernel version requirements for :baseline vs :latest

This commit is contained in:
germondai
2026-07-01 19:04:43 +02:00
parent a6ee080d44
commit c2b328d841
3 changed files with 5 additions and 3 deletions
+1 -1
View File
@@ -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
+2
View File
@@ -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
+2 -2
View File
@@ -123,8 +123,8 @@ const tabs: { id: Tab; label: string; hint: string }[] = [
</div>
<p class="tag-hint">
Older hardware or a Synology NAS without AVX2? Swap <code>:latest</code> for
<code>:baseline</code> in the image tag above
Older hardware or a Synology NAS without AVX2 / kernel &lt; 5.1? Swap <code>:latest</code> for
<code>:baseline</code> in the image tag above degrades gracefully down to kernel 3.10
<a :href="`${docsUrl}/deployment/standalone#older-cpus-synology-nas`">same commands, different runtime</a>.
</p>