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.
+:::
+
 <Tabs groupId="seaweedfs-install">
   <TabItem value="macos" label="macOS" default>
 
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).
 :::