qm-remote-migrate: add page (#23350)

This commit is contained in:
Adriano Inghingolo
2026-07-27 17:09:55 +02:00
committed by GitHub
parent b873ac9699
commit 609b59bcd6
+28
View File
@@ -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}}`