From f7cd4f2c74496fca8aa589c1e8223f2ce2e95add Mon Sep 17 00:00:00 2001
From: Hampus <hampus@fluxer.app>
Date: Wed, 19 Aug 2026 23:31:15 +0200
Subject: [PATCH] docs(operator): explain how to reclaim space after upgrades
 (#1767)

---
 fluxer_docs/docs/operator/get-started.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/fluxer_docs/docs/operator/get-started.md b/fluxer_docs/docs/operator/get-started.md
index 18e04130d..9e4a7d33b 100644
--- a/fluxer_docs/docs/operator/get-started.md
+++ b/fluxer_docs/docs/operator/get-started.md
@@ -277,6 +277,14 @@ The `fluxer-static` image is part of the default stack, so static asset updates
 
 To pin a specific release, set `FLUXER_IMAGE_TAG` in `.env` to the release tag you want, then pull and restart.
 
+Each upgrade leaves the previous images behind, which adds up to a few gigabytes over time. To reclaim that space:
+
+```bash
+docker image prune -f
+```
+
+This removes only the untagged images the upgrade replaced. `docker system prune -a` reclaims more, but it also deletes every image not currently used by a running container, including ones unrelated to Fluxer.
+
 ## Getting help
 
 - File issues and follow development on [GitHub](https://github.com/fluxerapp/fluxer).