From 5ea9aa74744125fa899b4d34aa5af1a940867d58 Mon Sep 17 00:00:00 2001 From: Richard R Date: Thu, 16 Apr 2026 17:13:24 -0600 Subject: [PATCH] docs: add warning about SeaweedFS 4.19 upload issues and pinning to 4.18 Document observed S3 `InternalError` regressions with SeaweedFS 4.19 in object storage, local development, and Docker quick start guides. Clarify that version 4.18 is pinned in CI and Docker builds for reliability while compatibility is investigated. --- docs-site/docs/configure/object-blob-storage.md | 5 +++++ docs-site/docs/deploy/local-development.md | 5 +++++ docs-site/docs/docker-quick-start.md | 5 +++++ 3 files changed, 15 insertions(+) diff --git a/docs-site/docs/configure/object-blob-storage.md b/docs-site/docs/configure/object-blob-storage.md index ff46fd1..99e1698 100644 --- a/docs-site/docs/configure/object-blob-storage.md +++ b/docs-site/docs/configure/object-blob-storage.md @@ -12,6 +12,11 @@ This page documents storage backends, blob upload routing, and core Docker mount - Embedded (default): SQLite metadata + embedded SeaweedFS (`weed mini`) blobs. - External: Postgres + external S3-compatible object storage. +:::warning SeaweedFS Compatibility Note (April 16, 2026) +OpenReader currently pins embedded SeaweedFS to `4.18` in CI and Docker builds. +`4.19` introduced intermittent `InternalError` responses on S3 `PutObject` in our upload flow. +::: + Storage variables are documented in [Environment Variables](../reference/environment-variables#database-and-object-blob-storage). ## Ports diff --git a/docs-site/docs/deploy/local-development.md b/docs-site/docs/deploy/local-development.md index dedc337..b771b49 100644 --- a/docs-site/docs/deploy/local-development.md +++ b/docs-site/docs/deploy/local-development.md @@ -17,6 +17,11 @@ npm install -g pnpm - A reachable TTS API server - [SeaweedFS](https://github.com/seaweedfs/seaweedfs) `weed` binary (required unless using external S3 storage) +:::warning SeaweedFS Compatibility Note (April 16, 2026) +If you see intermittent S3 `InternalError` upload failures with embedded storage, use SeaweedFS `4.18`. +OpenReader currently pins `4.18` in CI and Docker builds while `4.19` compatibility is investigated. +::: + diff --git a/docs-site/docs/docker-quick-start.md b/docs-site/docs/docker-quick-start.md index be015fe..6c6467a 100644 --- a/docs-site/docs/docker-quick-start.md +++ b/docs-site/docs/docker-quick-start.md @@ -10,6 +10,11 @@ import TabItem from '@theme/TabItem'; - A recent Docker version installed - A TTS API server that OpenReader can reach (Kokoro-FastAPI, KittenTTS-FastAPI, Orpheus-FastAPI, Replicate, DeepInfra, OpenAI, or equivalent) +:::warning SeaweedFS Compatibility Note (April 16, 2026) +OpenReader currently pins embedded SeaweedFS to `4.18` in CI and Docker builds. +`4.19` introduced intermittent `InternalError` responses on S3 `PutObject` in our upload flow. +::: + :::note If you have suitable hardware, you can run Kokoro locally with Docker. See [Kokoro-FastAPI](./configure/tts-provider-guides/kokoro-fastapi). :::