How to change hardware version in .vmx file on VMware ESXi

Written By Christian Castagna (Administrator)

Updated at January 14th, 2025

→ Applies to: VMware ESXi 6.5 and above

When you have VMware ESXi with different host versions, you may encounter some limitations.

In each scenario, SynetoOS performs all migration and protection operations as expected. However, you may encounter some issues when trying to start a VM that was migrated or replicated from another host, with a different ESXi version than the source one.

Each ESXi release has a virtual hardware version; if the affected hosts do not share the same version level, this article will help you understand how to proceed to resolve the issue.

The most common symptoms encountered are:

  • VM does not power on;
  • Some VMs operations are disabled and unavailable;
  • A guest OS experiences unexpected behavior;
  • The guest OS might report backup storage as a HDD instead of a SSD;
  • A VM cannot be registered, or it disappears from the VMs panel when it has already been registered.

 

Step 1. Login to VMware ESXi GUI (replace <your_ip_address_or_hostname> with the correct ip/hostname)

https://<your_ip_address_or_hostname>

 

Step 2. Power off and unregister the SynetoOS VM

 

Step 3. Connect to VMware ESXi via SSH as root (replace <your_ip_address_or_hostname> with the correct ip/hostname)

ssh root@<your_ip_address_or_hostname>

 

Step 4. Move to the folder where the .vmx file is located (replace <datastore_name> and <vm_name> with correct information)

cd /vmfs/volumes/<datastore_name>/<vm_name>

EXAMPLE

cd /vmfs/volumes/0e76279b-a3457e56/WinSRV_2022

 

Step 5. Edit .vmx file (replace <datastore_name> and <vm_name> with correct information)

vi /vmfs/volumes/<datastore_name>/<vm_name>

EXAMPLE

vi SynetoOS.vmx

 

Step 6. Find virtualHW.version on the .vmx file

virtualHW.version = "19"

EXAMPLE

 

Step 7. Identify the virtual hardware version needed

Virtual Hardware Version

Products

20

ESXi 8.0
Fusion 13.x
Workstation Pro 17.x
Workstation Player 17.x

19

ESXi 7.0 U2 (7.0.2)
Fusion 12.2.x
Workstation Pro 16.2.x
Workstation Player 16.2.x

18

ESXi 7.0 U1 (7.0.1)
Fusion 12.x
Workstation Pro 16.x
Workstation Player 16.x

17

ESXi 7.0  (7.0.0)

16

Fusion 11.x
Workstation Pro 15.x
Workstation Player 15.x

15

ESXi 6.7 U2

14

ESXi 6.7
Fusion 10.x
Workstation Pro 14.x
Workstation Player 14.x

13

ESXi 6.5

12

Fusion 8.x
Workstation Pro 12.x
Workstation Player 12.x

11

ESXi 6.0
Fusion 7.x
Workstation 11.x
Player 7.x

 

Step 8. Change virtualHW.version value on the .vmx file with the new number and save it

virtualHW.version = "20"

 

Step 9. Login to VMware ESXi GUI (replace <your_ip_address_or_hostname> with the correct ip/hostname)

https://<your_ip_address_or_hostname>

 

Step 10. Register the VM and power on SynetoOS