diff --git a/docs/index.html b/docs/index.html
index 257b2c9..b73e093 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -390,6 +390,15 @@ <h3>Download TissuePlex</h3>
       back to this folder (<code>cd ~/Documents/TissuePlex</code>), run
       <code>git pull</code>, then <code>docker compose up --build</code>.
     </div>
+
+    <div class="callout warn">
+      <strong class="label">Windows users:</strong> After a <code>git pull</code>,
+      Docker Desktop sometimes reuses a stale build cache and serves an outdated
+      version of the app, resulting in a black screen with an error about a wrong
+      MIME type in the browser console. If this happens, force a clean rebuild:
+      <pre style="margin-top:.6rem;"><code>docker compose build --no-cache
+docker compose up</code></pre>
+    </div>
   </div>
 </div>
 
@@ -1084,6 +1093,11 @@ <h2>Troubleshooting</h2>
       <td>TissuePlex is still processing the morphology image. Wait 15–30 seconds
       and refresh the page.</td>
     </tr>
+    <tr>
+      <td>Black screen after updating (especially on Windows)</td>
+      <td>Docker reused a stale build cache. Force a clean rebuild:<br>
+      <code>docker compose build --no-cache &amp;&amp; docker compose up</code></td>
+    </tr>
     <tr>
       <td>My dataset doesn't appear in the dropdown</td>
       <td>Check that <code>DATA_PATH</code> points to the parent folder and that