Knowledge Base

The VMware Knowledge Base provides support solutions, error messages and troubleshooting guides
 
Search the VMware Knowledge Base (KB)   View by Article ID
 

Editing the .vmx file for your VMware Fusion virtual machine (1014782)

Purpose

This article provides steps for editing the .vmx file of your VMware Fusion virtual machine. Editing of a .vmx file may be required to complete steps in a Knowledge Base article or at the request of VMware Support staff.

Resolution

Caution: Before you alter the virtual machine's files, VMware recommends copying the virtual machine's bundle to a safe location (either on an external hard drive or anywhere else on the Mac's hard drive) to backup the virtual machine. For more information, see Best practices for virtual machine backup (programs and data) (1013628).

To edit a .vmx file:

  1. Ensure the virtual machine is shut down (not suspended).
  2. In VMware Fusion, from the Apple menu bar, go to Window > Virtual Machine Library.

    Note: If the virtual machine is encrypted, you need to click on settings and enter the password when prompted.

  3. Hold the Option (Alt) key and right-click the virtual machine. Select Open Config File in Editor.

    For Fusion 6.x, 5.x, and 4.x:
    • Select Show in Finder
    • Option (Alt) key and right-click the virtual machine and select Show package Contents
    • Locate the .vmx file and open it in a text editor.

      You can now add or edit lines as needed. Lines are displayed in no particular order.

    Note: While editing the .vmx file in TextEdit, disable Smart Quotes option from TextEdit > Preferences > New Document. Smart quotes, if enabled, will not work in the .vmx file and the virtual machine will fail to boot.

  4. When finished, close the window which auto-saves it (Mountain Lion) or click Save a version (Lion) or Save (not Save As) (Snow Leopard and earlier), and exit.

The changes made to the .vmx do not take effect until the next time VMware Fusion is opened (quit it first, if it is currently open). Alternatively, double-click the .vmx file to apply the changes and open the virtual machine immediately.

Additional Information

The .vmx file contains settings for your virtual machine's behavior. Some of these settings are accessible through the Virtual Machine > Settings menu option, but some settings can be changed only in the file.

Tags

configuration-change  how-to  vm-configuration-file  virtual-machine-vmx-file

See Also

Update History

04/09/2010 - Updated Caution to include link to relevant KB article and included a video 08/18/2011 - Changed instructions for lion and added option+right-click instructions 08/23/2012 - Added Fusion 5.x to Products 09/07/2013 - Added Fusion 6.x to Products

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.

Feedback

  • 45 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.
What can we do to improve this information? (4000 or fewer characters)
  • 45 Ratings
Actions
KB: