From c18a7aa77e470acd66d20aef0489b3522552c4d5 Mon Sep 17 00:00:00 2001
From: ThePhaseless <kukubaorch@gmail.com>
Date: Fri, 6 Nov 2026 14:02:45 +0100
Subject: [PATCH] docs: stop recommending a tmpfs over /cache

/cache holds the browser baked into the image. A tmpfs over it hides
that browser, so Byparr downloads it again on every start (the cause
behind #439). Also move shm_size and tmpfs in compose.yaml out of the
build section, where they never applied to the running container.
---
 README.md    |  3 ++-
 compose.yaml | 10 +++++-----
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 2ae4f1b..7e0344e 100644
--- a/README.md
+++ b/README.md
@@ -71,8 +71,9 @@ docker compose up -d
 > shm_size: "1gb"
 > tmpfs:
 >   - /tmp:exec,mode=1777,size=1G
->   - /cache:mode=1777,size=512M
 >```
+>
+> Do not mount a tmpfs over `/cache`: it holds the browser baked into the image, and hiding it makes Byparr download it again on every start.
 
 ### Docker install
 
diff --git a/compose.yaml b/compose.yaml
index 3b659bf..21bff9c 100644
--- a/compose.yaml
+++ b/compose.yaml
@@ -7,11 +7,11 @@ services:
     build:
       context: .
       dockerfile: Dockerfile
-      shm_size: "1gb"
-    # Recommended to offload disk operations to RAM and reduce disk wear:
-      tmpfs:
-        - /tmp:exec,mode=1777,size=1G
-        - /cache:mode=1777,size=512M
+    shm_size: "1gb"
+    # Recommended to offload disk operations to RAM and reduce disk wear.
+    # Leave /cache on the image: it holds the baked-in browser.
+    tmpfs:
+      - /tmp:exec,mode=1777,size=1G
     # Uncomment below to use byparr outside of internal network
     # ports:
     #   - "8191:8191"