diff --git a/manual/extension/thumbnail-server.md b/manual/extension/thumbnail-server.md
index 05b7b58d..ffe7050e 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 (MB).
diff --git a/manual/repo/docker/thumbnail-server/thumbnail-server.yml b/manual/repo/docker/thumbnail-server/thumbnail-server.yml
index 5a2c07a1..65bc6dd1 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=${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:-}