From 609b59bcd6f05423b72cda03366a8ae0d44c631d Mon Sep 17 00:00:00 2001
From: Adriano Inghingolo <68734231+SpikeTheDragon40k@users.noreply.github.com>
Date: Mon, 27 Jul 2026 17:09:55 +0200
Subject: [PATCH] qm-remote-migrate: add page (#23350)

---
 pages/linux/qm-remote-migrate.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 pages/linux/qm-remote-migrate.md

diff --git a/pages/linux/qm-remote-migrate.md b/pages/linux/qm-remote-migrate.md
new file mode 100644
index 0000000000..c12f78a350
--- /dev/null
+++ b/pages/linux/qm-remote-migrate.md
@@ -0,0 +1,28 @@
+# qm remote-migrate
+
+> Migrate a virtual machine to a remote Proxmox host or cluster.
+> More information: <https://pve.proxmox.com/pve-docs/qm.1.html#cli_qm_remote-migrate>.
+
+- Migrate a VM to a remote host:
+
+`qm remote-migrate {{vmid}} {{target_vmid}} 'apitoken=PVEAPIToken={{user}}@{{realm}}!{{token}}={{secret}},host={{address}},fingerprint={{fingerprint}}' --target-bridge {{bridge}} --target-storage {{storage}}`
+
+- Migrate a running VM with live migration:
+
+`qm remote-migrate {{vmid}} {{target_vmid}} 'apitoken=PVEAPIToken={{user}}@{{realm}}!{{token}}={{secret}},host={{address}},fingerprint={{fingerprint}}' --target-bridge {{bridge}} --target-storage {{storage}} --online`
+
+- Delete the source VM after a successful migration:
+
+`qm remote-migrate {{vmid}} {{target_vmid}} 'apitoken=PVEAPIToken={{user}}@{{realm}}!{{token}}={{secret}},host={{address}},fingerprint={{fingerprint}}' --target-bridge {{bridge}} --target-storage {{storage}} --delete 1`
+
+- Limit migration bandwidth:
+
+`qm remote-migrate {{vmid}} {{target_vmid}} 'apitoken=PVEAPIToken={{user}}@{{realm}}!{{token}}={{secret}},host={{address}},fingerprint={{fingerprint}}' --target-bridge {{bridge}} --target-storage {{storage}} --bwlimit {{value}}`
+
+- Use the same bridge and storage names on the target:
+
+`qm remote-migrate {{vmid}} {{target_vmid}} 'apitoken=PVEAPIToken={{user}}@{{realm}}!{{token}}={{secret}},host={{address}},fingerprint={{fingerprint}}' --target-bridge 1 --target-storage 1`
+
+- Connect to a remote API on a custom port:
+
+`qm remote-migrate {{vmid}} {{target_vmid}} 'apitoken=PVEAPIToken={{user}}@{{realm}}!{{token}}={{secret}},host={{address}},fingerprint={{fingerprint}},port={{porta}}' --target-bridge {{bridge}} --target-storage {{storage}}`