From 2af9d6a140b2661336e664e12aee9cec9d4d8a12 Mon Sep 17 00:00:00 2001
From: Jizhou Deng <jizhou.deng@seafile.com>
Date: Wed, 22 Oct 2025 11:04:12 +0800
Subject: [PATCH 1/3] =?UTF-8?q?update=EF=BC=9Aadd=20THUMBNAIL=5FIMAGE=5FOR?=
 =?UTF-8?q?IGINAL=5FSIZE=5FLIMIT=20environment=20variable=20in=20thumbnail?=
 =?UTF-8?q?=20server?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 manual/extension/thumbnail-server.md                     | 5 +++++
 manual/repo/docker/thumbnail-server/thumbnail-server.yml | 1 +
 2 files changed, 6 insertions(+)

diff --git a/manual/extension/thumbnail-server.md b/manual/extension/thumbnail-server.md
index 05b7b58d..e47fe5ec 100644
--- a/manual/extension/thumbnail-server.md
+++ b/manual/extension/thumbnail-server.md
@@ -128,3 +128,8 @@ Placeholder spot for shared volumes. You may elect to store certain persistent i
 * /opt/seafile-data/logs: This is the directory for logs.
 * /opt/seafile-data/seafile-data: This is the directory for seafile storage (if you use local storage).
 * /opt/seafile-data/seahub-data/thumbnail: This is the directory for thumbnail files.
+
+## Common issues when settings up thumbnail server
+
+### Thumbnails cannot be generated for high-resolution images
+This is because generating thumbnails for high-resolution images can impact system performance. You can raise the threshold by setting the `THUMBNAIL_IMAGE_ORIGINAL_SIZE_LIMIT` environment variable in the env file; the default is 256.
diff --git a/manual/repo/docker/thumbnail-server/thumbnail-server.yml b/manual/repo/docker/thumbnail-server/thumbnail-server.yml
index 5a2c07a1..81041f4c 100644
--- a/manual/repo/docker/thumbnail-server/thumbnail-server.yml
+++ b/manual/repo/docker/thumbnail-server/thumbnail-server.yml
@@ -19,6 +19,7 @@ services:
       - JWT_PRIVATE_KEY=${JWT_PRIVATE_KEY:?Variable is not set or empty}
       - SITE_ROOT=${SITE_ROOT:-/}
       - INNER_SEAHUB_SERVICE_URL=${INNER_SEAHUB_SERVICE_URL:?Variable is not set or empty}
+      - THUMBNAIL_IMAGE_ORIGINAL_SIZE_LIMIT=${INNER_SEAHUB_SERVICE_URL:-256}
       - SEAF_SERVER_STORAGE_TYPE=${SEAF_SERVER_STORAGE_TYPE:-}
       - S3_COMMIT_BUCKET=${S3_COMMIT_BUCKET:-}
       - S3_FS_BUCKET=${S3_FS_BUCKET:-}

From 2fb0c46f2fc4a060a49044bba1da161b413cd7dc Mon Sep 17 00:00:00 2001
From: Djz <60094659+Djz0725@users.noreply.github.com>
Date: Wed, 22 Oct 2025 11:54:33 +0800
Subject: [PATCH 2/3] Update thumbnail-server.yml

---
 manual/repo/docker/thumbnail-server/thumbnail-server.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/manual/repo/docker/thumbnail-server/thumbnail-server.yml b/manual/repo/docker/thumbnail-server/thumbnail-server.yml
index 81041f4c..65bc6dd1 100644
--- a/manual/repo/docker/thumbnail-server/thumbnail-server.yml
+++ b/manual/repo/docker/thumbnail-server/thumbnail-server.yml
@@ -19,7 +19,7 @@ services:
       - JWT_PRIVATE_KEY=${JWT_PRIVATE_KEY:?Variable is not set or empty}
       - SITE_ROOT=${SITE_ROOT:-/}
       - INNER_SEAHUB_SERVICE_URL=${INNER_SEAHUB_SERVICE_URL:?Variable is not set or empty}
-      - THUMBNAIL_IMAGE_ORIGINAL_SIZE_LIMIT=${INNER_SEAHUB_SERVICE_URL:-256}
+      - THUMBNAIL_IMAGE_ORIGINAL_SIZE_LIMIT=${THUMBNAIL_IMAGE_ORIGINAL_SIZE_LIMIT:-256}
       - SEAF_SERVER_STORAGE_TYPE=${SEAF_SERVER_STORAGE_TYPE:-}
       - S3_COMMIT_BUCKET=${S3_COMMIT_BUCKET:-}
       - S3_FS_BUCKET=${S3_FS_BUCKET:-}

From 75a345cacff607b8f4d2e4140fca10412b977050 Mon Sep 17 00:00:00 2001
From: Daniel Pan <freeplant@gmail.com>
Date: Wed, 22 Oct 2025 12:15:04 +0800
Subject: [PATCH 3/3] Update thumbnail-server.md

---
 manual/extension/thumbnail-server.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/manual/extension/thumbnail-server.md b/manual/extension/thumbnail-server.md
index e47fe5ec..ffe7050e 100644
--- a/manual/extension/thumbnail-server.md
+++ b/manual/extension/thumbnail-server.md
@@ -132,4 +132,4 @@ Placeholder spot for shared volumes. You may elect to store certain persistent i
 ## Common issues when settings up thumbnail server
 
 ### Thumbnails cannot be generated for high-resolution images
-This is because generating thumbnails for high-resolution images can impact system performance. You can raise the threshold by setting the `THUMBNAIL_IMAGE_ORIGINAL_SIZE_LIMIT` environment variable in the env file; the default is 256.
+This is because generating thumbnails for high-resolution images can impact system performance. You can raise the threshold by setting the `THUMBNAIL_IMAGE_ORIGINAL_SIZE_LIMIT` environment variable in the env file; the default is 256 (MB).