Downgrading a VMware Virtual Machines hardware version

Modified on Fri, 4 Jul at 1:02 PM

Understanding the VM Hardware Version

Each virtual hardware version corresponds to a specific VMware product version (e.g., ESXi 7.0U2 uses version 19). Downgrading is useful when moving a VM to an older ESXi host or to ensure support with the DR2Cloud platform


⚠️ Important Notes

  • VMware does not officially support hardware version downgrades.

  • Always take a full backup or snapshot before proceeding.

  • You will need to edit the VMX file manually or export/import the VM in a compatible format.


Method: Manually Edit the VMX File

  1. Power off the VM and remove it from inventory (do not delete).

  2. SSH into the datastore or use the ESXi host file browser.

  3. Locate the VM's .vmx file and download it.

  4. Open the file in a text editor.

  5. Look for a line like:

    virtualHW.version = "20"

    Change it to the desired version, such as "19".

  6. Upload the .vmx file back and add the VM to inventory.

  7. Power on the VM and ensure it functions properly.


Tips

  • Check VMware compatibility matrix to match hardware versions with ESXi versions.

  • Downgrading may cause issues with newer guest OS features, VM tools, or devices.

  • If the VM fails to boot after a downgrade, revert to your backup or snapshot.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article