From 89197bbbc6d92ad30cf5cc48cb82d646d212043f Mon Sep 17 00:00:00 2001
From: Rostislav Dugin <rostislav.dugin@outlook.com>
Date: Fri, 20 Mar 2026 17:41:09 +0300
Subject: [PATCH] FEATURE (restore): Add restore hint for Docker

---
 .../backups/ui/AgentRestoreComponent.tsx      | 27 +++++++++++++++++--
 1 file changed, 25 insertions(+), 2 deletions(-)

diff --git a/frontend/src/features/backups/ui/AgentRestoreComponent.tsx b/frontend/src/features/backups/ui/AgentRestoreComponent.tsx
index 828d82f..79dc425 100644
--- a/frontend/src/features/backups/ui/AgentRestoreComponent.tsx
+++ b/frontend/src/features/backups/ui/AgentRestoreComponent.tsx
@@ -207,7 +207,30 @@ volumes:
 
       <div>
         <div className="font-semibold dark:text-white">
-          Step {isDocker ? '5' : '4'} — Start PostgreSQL
+          Step {isDocker ? '5' : '4'} — Handle archive_command
+        </div>
+        <p className="mt-1 text-sm text-gray-600 dark:text-gray-400">
+          The restored backup includes the original <code>archive_command</code> configuration.
+          PostgreSQL will fail to archive WAL files after recovery unless you either:
+        </p>
+        <ul className="mt-1 list-disc pl-5 text-sm text-gray-600 dark:text-gray-400">
+          <li>
+            <strong>Re-attach the agent</strong> — mount the WAL queue directory and start the
+            databasus agent on the restored instance, same as the original setup.
+          </li>
+          <li>
+            <strong>Disable archiving</strong> — if you don&apos;t need continuous backups yet,
+            comment out or reset the archive settings in <code>postgresql.auto.conf</code>:
+          </li>
+        </ul>
+        {renderCodeBlock(`# In ${targetDirPlaceholder}/postgresql.auto.conf, remove or comment out:
+# archive_mode = on
+# archive_command = '...'`)}
+      </div>
+
+      <div>
+        <div className="font-semibold dark:text-white">
+          Step {isDocker ? '6' : '5'} — Start PostgreSQL
         </div>
         <p className="mt-1 text-sm text-gray-600 dark:text-gray-400">
           Start PostgreSQL to begin WAL recovery. It will automatically replay WAL segments.
@@ -218,7 +241,7 @@ volumes:
       </div>
 
       <div>
-        <div className="font-semibold dark:text-white">Step {isDocker ? '6' : '5'} — Clean up</div>
+        <div className="font-semibold dark:text-white">Step {isDocker ? '7' : '6'} — Clean up</div>
         <p className="mt-1 text-sm text-gray-600 dark:text-gray-400">
           After recovery completes, remove the WAL restore directory:
         </p>