From 4f7ccdedb51c15e83407ed057a851c46d554730d Mon Sep 17 00:00:00 2001
From: "Simon L." <szaimen@e.mail.de>
Date: Fri, 27 Feb 2026 14:48:21 +0100
Subject: [PATCH] aio-interface: offer system prune button

Signed-off-by: Simon L. <szaimen@e.mail.de>
---
 php/public/index.php                    |  1 +
 php/src/Controller/DockerController.php |  5 ++++
 php/src/Docker/DockerActionManager.php  | 32 +++++++++++++++++++++++++
 php/templates/containers.twig           |  5 ++++
 4 files changed, 43 insertions(+)

diff --git a/php/public/index.php b/php/public/index.php
index fb4f6117..c5336cfd 100644
--- a/php/public/index.php
+++ b/php/public/index.php
@@ -66,6 +66,7 @@ $app->post('/api/docker/backup-check-repair', AIO\Controller\DockerController::c
 $app->post('/api/docker/backup-test', AIO\Controller\DockerController::class . ':StartBackupContainerTest');
 $app->post('/api/docker/restore', AIO\Controller\DockerController::class . ':StartBackupContainerRestore');
 $app->post('/api/docker/stop', AIO\Controller\DockerController::class . ':StopContainer');
+$app->post('/api/docker/prune', AIO\Controller\DockerController::class . ':SystemPrune');
 $app->get('/api/docker/logs', AIO\Controller\DockerController::class . ':GetLogs');
 $app->post('/api/auth/login', AIO\Controller\LoginController::class . ':TryLogin');
 $app->get('/api/auth/getlogin', AIO\Controller\LoginController::class . ':GetTryLogin');
diff --git a/php/src/Controller/DockerController.php b/php/src/Controller/DockerController.php
index dc3a292e..cc7012fb 100644
--- a/php/src/Controller/DockerController.php
+++ b/php/src/Controller/DockerController.php
@@ -285,6 +285,11 @@ readonly class DockerController {
         return $response->withStatus(201)->withHeader('Location', '.');
     }
 
+    public function SystemPrune(Request $request, Response $response, array $args) : Response {
+        $this->dockerActionManager->SystemPrune();
+        return $response->withStatus(201)->withHeader('Location', '.');
+    }
+
     public function stopTopContainer() : void {
         $id = self::TOP_CONTAINER;
         $this->PerformRecursiveContainerStop($id);
diff --git a/php/src/Docker/DockerActionManager.php b/php/src/Docker/DockerActionManager.php
index 5ac1c60e..bbf0d53b 100644
--- a/php/src/Docker/DockerActionManager.php
+++ b/php/src/Docker/DockerActionManager.php
@@ -983,4 +983,36 @@ readonly class DockerActionManager {
             return $this->dockerHubManager->GetLatestDigestOfTag($imageName, $tag);
         }
     }
+
+    public function SystemPrune(): void {
+        $endpoints = [
+            // Remove stopped containers
+            'containers/prune',
+            // Remove unused images
+            'images/prune',
+            // Remove unused volumes
+            'volumes/prune',
+            // Remove unused networks
+            'networks/prune',
+            // Prune build cache
+            'build/prune',
+        ];
+
+        foreach ($endpoints as $endpoint) {
+            // Special-case images prune to include the dangling filter as requested
+            if ($endpoint === 'images/prune') {
+                $filters = json_encode(['dangling' => ['false']]);
+                $url = $this->BuildApiUrl($endpoint . '?filters=' . urlencode($filters));
+            } else {
+                $url = $this->BuildApiUrl($endpoint);
+            }
+
+            try {
+                $this->guzzleClient->post($url);
+            } catch (RequestException $e) {
+                error_log(sprintf('Docker prune (%s) failed: %s', $endpoint, $e->getMessage()));
+                // continue with next prune step
+            }
+        }
+    }
 }
diff --git a/php/templates/containers.twig b/php/templates/containers.twig
index ebe2552f..a2a5198d 100644
--- a/php/templates/containers.twig
+++ b/php/templates/containers.twig
@@ -322,6 +322,11 @@
                                 <input type="hidden" name="{{csrf.keys.value}}" value="{{csrf.value}}">
                                 <input type="submit" value="Stop containers" />
                             </form>
+                            <form method="POST" action="api/docker/prune" class="xhr">
+                                <input type="hidden" name="{{csrf.keys.name}}" value="{{csrf.name}}">
+                                <input type="hidden" name="{{csrf.keys.value}}" value="{{csrf.value}}">
+                                <input type="submit" value="Run docker system prune" onclick="return confirm('Run docker system prune? This will remove unused images, containers and volumes. Continue?')" />
+                            </form>
                         {% endif %}
                     {% else %}
                         {% if isBackupOrRestoreRunning == true %}