To enable shared folders on an Ubuntu virtual machine using open-vm-tools, you must install the tool suite, mount the host directory to a local point in the guest OS, and configure persistent access via system settings. This process bridges the host-guest gap by leveraging VMware's integration features, allowing seamless file exchange without network overhead or complex protocol configurations.
Prerequisites and Installation
Before configuring shared folders, ensure that
open-vm-tools is installed and running within your Ubuntu guest. While many modern distributions include this package by default, it may need to be explicitly enabled. Open a terminal in your Ubuntu VM and execute the following command to install the necessary components:
sudo apt update
sudo apt install open-vm-tools open-vm-tools-desktop
The
open-vm-tools-desktop package is critical because it includes the service required for graphical desktop integration, including shared folder support. After installation, restart the virtual machine to ensure the services initialize correctly. You can verify the installation by checking the status of the VMware tools service:
systemctl status vmtoolsd
If the service is active and running, you are ready to proceed with configuration. If it is inactive, start it manually using
sudo systemctl start vmtoolsd and set it to start on boot with
sudo systemctl enable vmtoolsd.
Configuring Shared Folders in VMware
The first step in enabling shared folders is to define them in the VMware host interface. This can be done through the VMware Workstation or ESXi management console. Navigate to the settings of your specific virtual machine. Look for the
Options tab, then select
VMware Tools or
Shared Folders depending on your VMware version.
In the Shared Folders section, click
Add to create a new mapping. You will need to specify two paths:
1.
Host Path: The directory on your physical host machine that you wish to share.
2.
Guest Name: The name that will appear inside the Ubuntu guest OS.
Ensure that the option
Always enabled is checked. This ensures that the shared folder is available immediately upon startup, rather than requiring manual mounting each time. Save the settings and power on the virtual machine if it was off.
Mounting the Shared Folder in Ubuntu
Once the virtual machine is running, the shared folder should be accessible. By default, open-vm-tools mounts shared folders under the
/mnt/hgfs/ directory. To verify this, navigate to that path in the file manager or use the terminal:
ls -l /mnt/hgfs/
You should see the
Guest Name you defined earlier listed here. If the directory is empty, the service may not have started correctly, or the permissions might be incorrect. In most cases, the folder is mounted automatically. However, if you prefer a different location or want to customize the mount point, you can manually mount it using the
vmhgfs-fuse command:
sudo mkdir -p /media/shared
sudo vmhgfs-fuse .host:/GuestName /media/shared
Replace
<GuestName> with the actual name configured in VMware. This command mounts the host directory to
/media/shared in the guest. Note that manual mounts do not persist across reboots unless added to system configuration files.
Persistent Access via /etc/fstab
For a robust solution that survives reboots, add the shared folder to the
/etc/fstab file. This ensures that the folder is mounted automatically when the system starts. Edit the fstab file using a text editor:
sudo nano /etc/fstab
Add the following line at the end of the file, replacing
<GuestName> with your folder name and adjusting the mount point as desired:
.host:/GuestName /mnt/hgfs/GuestName fuse.vmhgfs-fuse allow_other,uid=1000,gid=1000 0 0
The
allow_other parameter is crucial as it permits non-root users to access the shared folder. The
uid and
gid parameters ensure that the files are owned by your user account, preventing permission errors. Save the file and exit the editor. You can now test the persistence by rebooting the VM and verifying that the folder is accessible at the specified mount point.
Troubleshooting Common Issues
If you encounter issues where the shared folder is not visible or cannot be accessed, consider the following steps. First, check if the
open-vm-tools service is running. Second, ensure that the VMware host settings have the shared folder enabled and that the path exists on the host machine. Third, verify permissions on the host side; the user running the VMware process must have read/write access to the shared directory.
For deeper debugging, check the system logs for errors related to
vmtoolsd:
journalctl -u vmtoolsd
This log output can provide specific error messages that indicate why the mounting process failed. Additionally, ensure that no other filesystem managers are conflicting with the
/mnt/hgfs directory. In rare cases, reinstalling
open-vm-tools and restarting the VM can resolve persistent mounting issues.
For more information on managing virtual machines efficiently, you might find it useful to read about
How to Run a Portable Virtual Machine on an External SSD, which covers storage optimization techniques relevant to VM performance. Another helpful resource is
Can't Connect to VM Remotely: Troubleshooting Guide, which addresses connectivity issues that often accompany virtualization setups.
Frequently Asked Questions
Why is the /mnt/hgfs directory empty?
The directory is likely empty because the
open-vm-tools service has not started or the shared folder is not enabled in the VMware settings. Verify that the service is active and that the "Always enabled" option is selected in the host configuration.
Can I share folders between two Ubuntu guests?
No, shared folders are designed for communication between the host and the guest. To share files between two guests, you should use a network-based solution such as NFS or Samba, or utilize a shared virtual disk attached to both VMs.
How do I change the permissions of a shared folder?
Permissions are controlled by the
uid and
gid parameters in the
/etc/fstab entry or the
vmhgfs-fuse command. Adjust these values to match your user account's ID and group ID to grant appropriate access levels.
Does open-vm-tools work on Windows hosts?
Yes,
open-vm-tools is cross-platform and works seamlessly with VMware hosts running Windows, Linux, or macOS. The shared folder mechanism relies on the VMware hypervisor layer, which is consistent across all host operating systems.
What if I cannot write to the shared folder?
Write access is usually denied if the
allow_other flag is missing from the mount options or if the host directory permissions restrict writing. Ensure that the host directory allows write access for the user running the VMware process and that the guest mount options include
allow_other.