From f70ae0397e8cdec9a40f7d23466928b9cfb01f13 Mon Sep 17 00:00:00 2001 From: Alan Grainger <16197738+alangrainger@users.noreply.github.com> Date: Fri, 4 Sep 2026 23:35:42 +1200 Subject: [PATCH] Update docs --- docs/installation.md | 4 ++-- docs/troubleshooting.md | 5 +++-- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/installation.md b/docs/installation.md index fc6d36c..f06750c 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -31,8 +31,8 @@ Now whenever you share an image or gallery through Immich, it will automatically you. > [!WARNING] -> If you're using Cloudflare, please make sure to set your `/share/video/*` and `/share/*/download` paths to Bypass -> Cache, otherwise you may run into video playback issues and failed zip downloads. See +> If you're using Cloudflare, please make sure to set your `/share/video/*`, `/share/*/download` and `/s/*/download` +> paths to Bypass Cache, otherwise you may run into video playback issues and failed zip downloads. See > [Troubleshooting](/troubleshooting) for more information. Those two variables are all most people need. The port and the config file location are covered under diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index 9369eef..8dfd5a8 100644 --- a/docs/troubleshooting.md +++ b/docs/troubleshooting.md @@ -11,8 +11,9 @@ set to bypass cache. I ran into this issue myself, and found ## "Download all" fails partway through If you use Cloudflare with a "cache everything" rule and large zip downloads stop with a browser error after a few -seconds, add a cache rule that bypasses cache for `/share/*/download`, the same as for `/share/video/*` above. From -v3.3.0 the zip is streamed as it is fetched from Immich, and Cloudflare's cache cuts those downloads short. +seconds, add a cache rule that bypasses cache for `/share/*/download` and `/s/*/download` (the slug-link form), the +same as for `/share/video/*` above. From v3.3.0 the zip is streamed as it is fetched from Immich, and Cloudflare's +cache cuts those downloads short. Versions after v3.3.0 send the zip with `Cache-Control: no-store`, which is enough on its own if your cache rule's Edge TTL is set to respect the origin. If the rule overrides the Edge TTL, Cloudflare ignores that header and you need the