Loading...

We've detected that your browser language is Chinese. Would you like to visit our Chinese website? [ Dismiss ]
By: Dervish

What Is Proxmox Live Migration?

Virtual machine migration is an important capability for modern virtualization environments. It allows administrators to move workloads between hosts for hardware maintenance, resource optimization, and infrastructure upgrades without causing significant service disruption.

Proxmox live migration enables administrators to move a running virtual machine from one Proxmox VE node to another while keeping downtime to a minimum. During the migration process, Proxmox transfers the VM runtime state, including memory and device information, to the destination node while the workload continues running.

Proxmox live migration is commonly used for:

  • Performing server maintenance without shutting down applications
  • Balancing VM workloads across cluster nodes
  • Moving workloads to new hardware or infrastructure

This guide explains how Proxmox live migration works, the requirements you need to prepare, and how to migrate running VMs using the Proxmox Web GUI and command line.

proxmox live migration

How Does Proxmox Live Migration Work?

Proxmox live migration is the process of moving a running virtual machine from one Proxmox VE node to another without manually powering off the VM.

During a live migration, Proxmox transfers the VM’s runtime state from the source node to the destination node. This includes:

  • Virtual CPU state
  • Memory contents
  • Device state
  • Network configuration
  • Storage access information

The migration process typically uses a pre-copy approach, where Proxmox copies VM memory pages to the destination node while the VM continues running. If memory pages are changed during the transfer, those modified pages are copied again until the remaining changes are small enough for the final switchover.

The final migration stage briefly pauses the VM, transfers the remaining state, and resumes the VM on the destination node.

The actual migration time depends on several factors, including the VM memory size, available network bandwidth, storage configuration, the amount of memory changes generated by the workload, and CPU and hardware compatibility between the source and destination nodes.

Proxmox Live Migration Requirements & Prerequisites

Before performing a Proxmox live migration, administrators should ensure that the source and destination nodes meet the necessary requirements.

Cluster and Network Requirements

Proxmox native live migration is primarily designed for nodes within the same Proxmox VE cluster. The source and destination nodes should have stable communication, compatible Proxmox VE versions, and properly configured network settings.

For production environments, a dedicated network for cluster communication and migration traffic is recommended. This helps prevent migration operations from affecting normal application traffic.

Storage Requirements

Storage configuration is an important factor that affects Proxmox live migration performance.

With shared storage, such as Ceph, NFS, or iSCSI, both nodes can access the same VM disks. In this case, Proxmox mainly transfers VM runtime information, making migration faster.

With local storage, Proxmox must also transfer the VM disk data to the destination node. This requires additional bandwidth and usually takes longer than shared storage migration.

CPU and Hardware Compatibility

The source and destination nodes should have compatible CPU configurations to support successful migration.

Migration issues may occur when hosts have different CPU features or when the VM relies on hardware passthrough devices, such as dedicated GPUs or controllers. Before migration, administrators should verify CPU compatibility and hardware dependencies.

How to Perform Proxmox Live Migration (Step-by-Step)

Proxmox provides two main ways to migrate running virtual machines:

  1. Using the Proxmox Web GUI
  2. Using the command line interface (CLI)

Both methods perform the same underlying migration operation.

Method 1: Perform Proxmox Live Migration Using Web GUI

The Proxmox Web GUI provides the easiest way to migrate a running VM between cluster nodes.

Follow these steps:

Step 1. Select the Virtual Machine.

Log in to the Proxmox Web Interface and select the VM you want to migrate.

Before starting migration, confirm that:

  • The destination node is available
  • Required storage is accessible
  • The VM configuration is compatible with the target node

Step 2. Start the Migration。

Select the destination node and configure migration options if required. For VMs using local storage, enable the option to migrate local disks.

Step 3. Monitor Migration Progress

After starting the migration, Proxmox displays the migration progress, including transferred data, remaining data, and migration speed.

Once completed, the VM will continue running on the destination node.

Method 2: Perform Proxmox Live Migration Using CLI

For administrators who prefer command-line management, Proxmox provides the qm migrate command.

The basic syntax is:

bash
qm migrate <VM_ID> <TARGET_NODE> --online

Example:

bash
qm migrate 101 pve-node2 --online

Where:

  • 101 is the VM ID
  • pve-node2 is the destination Proxmox node
  • --online enables live migration while the VM is running

Migrating VMs with Local Disks

If the VM uses local storage instead of shared storage, include the --with-local-disks option:

bash
qm migrate 101 pve-node2 --online --with-local-disks

This allows Proxmox to migrate both the running VM state and local virtual disks.

Monitoring Migration Status

During CLI-based migration, administrators can monitor the migration output directly from the terminal.

For larger environments, migration progress can also be monitored through the Proxmox Web GUI.

How Does Proxmox Live Migration Work?

Proxmox live migration generally consists of three stages: pre-check, memory synchronization, and final switchover.

Pre-check phase

Proxmox verifies cluster connectivity, resource availability, storage accessibility, and hardware compatibility before migration starts.

Memory synchronization phase

During this stage, the VM continues running while Proxmox transfers memory pages to the destination node using a pre-copy approach. Modified memory pages are synchronized again until the remaining changes can be transferred during the final switchover.

Final switchover phase

The VM is briefly paused, remaining runtime data is transferred, and the workload resumes on the destination node with minimal interruption.

Proxmox Live Migration Best Practices

To ensure reliable Proxmox live migration, administrators should prepare sufficient CPU, memory, storage, and network resources on the destination node before migration. A dedicated migration network is recommended for production environments because large VM transfers can consume significant bandwidth. In addition, keeping Proxmox VE versions, storage configurations, and network bridge settings consistent across nodes can help prevent compatibility issues.

Common Proxmox Live Migration Issues and Troubleshooting

Common Proxmox live migration failures are usually caused by configuration differences, insufficient resources, or hardware limitations. The most frequent issues include:

  • CPU Compatibility Issues: Migration may fail when the destination node does not support the VM’s CPU features. Ensure both nodes use compatible CPU configurations.
  • Storage Configuration Mismatch: Verify that the destination node can access the required storage and has sufficient capacity for the VM.
  • Network Configuration Problems: Ensure that network bridges, VLAN settings, and other network configurations are consistent across Proxmox nodes.
  • Hardware Passthrough Limitations: VMs using PCI passthrough devices, such as GPUs, may not support live migration because these devices are directly attached to the source host.

Limitations of Native Proxmox Live Migration

Proxmox native live migration provides an efficient way to move workloads between Proxmox VE nodes, but it also has several limitations.

Limited to Proxmox VE Cluster Environments

Native Proxmox live migration is primarily designed for moving VMs between nodes within the same Proxmox VE cluster. If organizations need to migrate workloads between independent clusters or different infrastructures, additional migration methods may be required.

No Native Cross-Platform Live Migration

Proxmox supports VM migration within its own ecosystem, but it does not provide built-in live migration between different virtualization platforms such as VMware ESXi, Hyper-V, and other hypervisors.

Cross-platform migration usually requires additional processes, including VM export/import, virtual disk conversion, hardware reconfiguration, and application validation.

Hardware-Dependent Workloads Require Additional Planning

VMs that rely on hardware passthrough, specialized network adapters, or other physical device dependencies may not support live migration. These workloads should be evaluated carefully before migration planning.

For organizations that need to migrate workloads across different hypervisors, clusters, or physical environments with minimal disruption, dedicated migration solutions can provide more flexibility than native Proxmox migration tools.

Native Proxmox Migration vs Enterprise Migration Solutions

Proxmox VE provides built-in migration capabilities that work well for many virtualization environments, especially when moving VMs between nodes inside the same Proxmox cluster.

However, native Proxmox live migration is mainly designed for infrastructure management within the Proxmox ecosystem. When organizations need to migrate workloads across different platforms, clusters, or physical environments, additional migration solutions may provide greater flexibility.

The main differences are shown below:

Feature Native Proxmox Live Migration Enterprise Migration Solutions
Migration scope Mainly within the same Proxmox VE cluster Cross-cluster and cross-platform migration
Source platforms Proxmox VE environments Proxmox, VMware, Hyper-V, physical servers, and other platforms
Downtime reduction Minimizes downtime within supported scenarios Designed for near-zero downtime migration with continuous replication
Storage dependency Often requires compatible cluster storage configuration Supports migration across different storage environments
Migration management Managed through Proxmox VE tools Centralized migration workflows and automation

For organizations managing a single Proxmox cluster, native migration tools are usually sufficient. However, enterprises performing infrastructure modernization, virtualization platform changes, or large-scale workload relocation may require dedicated migration software.

Cross-Platform Migration with i2Migration

While Proxmox native live migration works well for moving VMs within the same Proxmox VE cluster, organizations may need a more flexible solution when migrating workloads across different platforms, clusters, or physical environments.

i2Migration helps simplify these complex migration scenarios by supporting cross-platform workload migration with minimal downtime. It enables organizations to migrate physical servers and virtual machines across heterogeneous environments while reducing the complexity of traditional export, conversion, and manual migration processes.

Key scenarios supported by i2Migration include:

  • Physical-to-virtual (P2V) migration
  • Virtual machine migration across different hypervisor platforms
  • Cross-cluster and cross-environment workload migration
  • Migration with continuous data synchronization to minimize downtime
FREE Trial for 60-Day

For organizations planning infrastructure modernization, data center migration, or virtualization platform transitions, i2Migration provides a more flexible alternative when native Proxmox migration capabilities are not sufficient.

FAQs About Proxmox Live Migration

Does Proxmox support live migration?

Yes. Proxmox VE supports live migration, allowing running virtual machines to be moved between compatible Proxmox nodes with minimal interruption.

Does Proxmox live migration require shared storage?

No. Proxmox supports live migration with both shared storage and local storage. Shared storage usually provides faster migration because VM disks are already accessible from the destination node, while local disk migration requires transferring the VM storage data.

How does Proxmox live migration work?

Proxmox live migration uses a pre-copy migration process. The VM continues running while memory pages are transferred to the destination node, followed by a brief final switchover to complete the migration.

How long does Proxmox live migration take?

Migration time depends on factors such as VM memory size, network bandwidth, storage configuration, and workload activity. Larger VMs or workloads with frequent memory changes usually require more time to migrate.

Can Proxmox migrate VMs between different hypervisors?

No. Proxmox native live migration is designed for Proxmox VE environments and does not provide built-in live migration between platforms such as VMware ESXi or Hyper-V.

For cross-platform migration scenarios, organizations typically need additional migration tools or a manual export and conversion process.

Does Proxmox live migration cause downtime?

Proxmox live migration is designed to minimize downtime. During the final switchover stage, the VM may experience a brief interruption while the remaining runtime state is transferred to the destination node.

Conclusion

Proxmox live migration provides administrators with an effective way to move running virtual machines between Proxmox VE nodes while minimizing service interruption. By understanding its requirements, migration process, best practices, and limitations, organizations can better plan VM mobility and infrastructure maintenance.

For environments operating within a single Proxmox cluster, native migration tools are usually sufficient. However, organizations requiring cross-platform migration, cross-cluster movement, or migration from physical infrastructure may benefit from dedicated migration solutions.

With support for heterogeneous environments and reduced migration complexity, i2Migration helps businesses modernize infrastructure and move workloads with greater flexibility.

A core member of info2soft's technical team, specializing in enterprise data management and IT operations. Focused on data backup, disaster recovery solutions, and product iteration optimization, he breaks down technical challenges with practical experience to deliver highly implementable content.

More Related Articles

Table of Contents:
Stay Updated on Latest Tips
Subscribe to our newsletter for the latest insights, news, exclusive content. You can unsubscribe at any time.
Subscribe
Ready to Enhance Business Data Security?
Start a 60-day free trial or view demo to see how Info2soft protects enterprise data.
Please fill out the form and submit it, our customer service representative will contact you soon.
By submitting this form, I confirm that I have read and agree to the Privacy Notice.
{{ isSubmitting ? 'Submitting...' : 'Submit' }}