From f24ae18edb2daf0bf28f98046286f1082b57b61a Mon Sep 17 00:00:00 2001 From: Albert Bausili Date: Wed, 21 Oct 2026 04:15:49 +0200 Subject: [PATCH] docs: the minimum Go version is 1.27.3 (celeris moved its toolchain for GO-2026-6809) --- src/content/docs/getting-started.md | 2 +- src/content/docs/introduction.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/docs/getting-started.md b/src/content/docs/getting-started.md index 187d349..370b30a 100644 --- a/src/content/docs/getting-started.md +++ b/src/content/docs/getting-started.md @@ -14,7 +14,7 @@ Celeris source. | Requirement | Notes | | --- | --- | -| **Go 1.27.2 or newer** | Celeris targets the current Go toolchain. | +| **Go 1.27.3 or newer** | Celeris targets the current Go toolchain. | | **Linux** for the high-performance engines | The `io_uring` engine needs kernel **5.10+**; the `epoll` engine needs kernel **3.10+**. | | Any other OS (macOS, Windows, BSD) | Supported via automatic fallback to the portable `std` (`net/http`) engine — no code changes needed. | diff --git a/src/content/docs/introduction.md b/src/content/docs/introduction.md index 633a72f..bf0e502 100644 --- a/src/content/docs/introduction.md +++ b/src/content/docs/introduction.md @@ -127,7 +127,7 @@ around Celeris. | **Native engines are Linux-only** | io_uring, epoll, and adaptive exist only on Linux. On macOS/Windows/BSD, Celeris automatically uses the **std** (`net/http`) engine — your code is unchanged, but you won't see native-engine performance off Linux. This fallback is automatic; you do not configure it. | | **No built-in TLS** | Celeris has **no HTTPS listener and no TLS configuration** — `Config` exposes no certificate fields, and every engine (io_uring, epoll, adaptive, and std) binds a plain TCP listener. Terminate TLS at an upstream proxy (Caddy, Nginx, Envoy) and forward cleartext to Celeris. See [Deployment](/docs/deployment). | | **Cleartext H1 / h2c only** | Protocols are HTTP/1.1 and HTTP/2 *cleartext* (h2c). There is no h2 over TLS (ALPN) because there is no TLS. `Protocol: celeris.Auto` (the default) detects H1 vs h2c per connection. | -| **Go 1.27.2+** | Celeris requires a modern toolchain (the module declares `go 1.27.2`). Build with Go 1.27.2 or newer. | +| **Go 1.27.3+** | Celeris requires a modern toolchain (the module declares `go 1.27.3`). Build with Go 1.27.3 or newer. | > **Common pitfall — expecting `https://`.** A fresh Celeris server listens on > plain TCP. `curl https://localhost:8080` will fail; `curl http://localhost:8080` @@ -145,7 +145,7 @@ Operations. If you just want to ship, jump straight to - **Module:** `github.com/goceleris/celeris` · **package:** `celeris`. - **Version:** the running version is the exported `celeris.Version` constant (currently `1.5.8`). Pin a version in your `go.mod` and upgrade deliberately. -- **Go toolchain:** Go 1.27.2+ (the module targets `go 1.27.2`). +- **Go toolchain:** Go 1.27.3+ (the module targets `go 1.27.3`). - **Platforms:** Linux for io_uring/epoll/adaptive; any OS Go supports for the std engine. The engine choice is automatic unless you set [`Config.Engine`](/docs/configuration).