From ec5298a61b63095a558e1bf32cfafedff9a0bb96 Mon Sep 17 00:00:00 2001
From: Yan Bondarenko <202671653+yankawai@users.noreply.github.com>
Date: Tue, 15 Sep 2026 10:24:45 +0300
Subject: [PATCH] docs(platform-package): document KubeVirt migration settings

Signed-off-by: Yan Bondarenko <202671653+yankawai@users.noreply.github.com>
---
 .../configuration/platform-package.md          | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/content/en/docs/next/operations/configuration/platform-package.md b/content/en/docs/next/operations/configuration/platform-package.md
index 8956aab3..5cf12741 100644
--- a/content/en/docs/next/operations/configuration/platform-package.md
+++ b/content/en/docs/next/operations/configuration/platform-package.md
@@ -204,6 +204,24 @@ registries:
 | `resources.memoryAllocationRatio` | `1` | Memory allocation ratio: `1/memoryAllocationRatio` memory requested per unit of configured memory. |
 | `resources.ephemeralStorageAllocationRatio` | `40` | Ephemeral storage allocation ratio: `1/ephemeralStorageAllocationRatio` ephemeral storage requested per unit of configured storage. |
 
+#### KubeVirt migrations
+
+| Value | Default | Description |
+| --- | --- | --- |
+| `kubevirt.migrations` | `{}` | Cluster-wide settings forwarded to `spec.configuration.migrations` on the KubeVirt CR. Set them through the platform Package so they are part of the rendered configuration. An empty or null map leaves KubeVirt's defaults unchanged. |
+
+Example under `spec.components.platform.values`:
+
+```yaml
+kubevirt:
+  migrations:
+    bandwidthPerMigration: 625M
+    parallelMigrationsPerCluster: 2
+    parallelOutboundMigrationsPerNode: 1
+```
+
+`bandwidthPerMigration` is a quantity in bytes per second: `625M` is 625,000,000 bytes/s (5 Gbit/s) per migration. This example allows up to two migrations across the cluster and one outbound migration per node.
+
 #### Internal fields
 
 These fields are managed automatically by the Cozystack operator and should not be modified manually.