From f811805c65e5a53d51d4cf43043db525b676c136 Mon Sep 17 00:00:00 2001
From: AbelLykens <47113175+AbelLykens@users.noreply.github.com>
Date: Thu, 4 Dec 2025 10:06:45 +0100
Subject: [PATCH] docs: update sql migration guide

---
 docs/db_migration_guide.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/db_migration_guide.md b/docs/db_migration_guide.md
index 297999643..e973adb7a 100644
--- a/docs/db_migration_guide.md
+++ b/docs/db_migration_guide.md
@@ -127,6 +127,9 @@ This will mitigate the poor Postgres performance on kvdb.
 
 This stage unlocks true SQL performance by restructuring data into relational tables. Migration is **per-subsystem** and **incremental**.
 
+The migration steps are automatically applied when LND is restarted after step 1 was successfully completed and the config value db.use-native-sql=true is set.
+You will see log lines from the `SQLD` subsystem about the migration, such as `Starting migration of invoices from KV to SQL`.
+
 ### Subsystem Readiness
 
 | Subsystem           | Relational Backend | Migration Script | Status |