Install VMware Tools in Ubuntu Guest: Step-by-Step

To install VMware Tools in an Ubuntu guest, you mount the VMware Tools ISO from the VM menu, extract the installer, and run sudo ./vmware-install.pl in a terminal. For most modern Ubuntu versions, the open-source open-vm-tools package (installed via sudo apt install open-vm-tools) is the recommended and simpler alternative. This article explains both methods, why you need them, and how to troubleshoot common issues.

Why VMware Tools Matter

VMware Tools is a suite of drivers and services that improves the performance and usability of a virtual machine. Without it, your Ubuntu guest may have poor screen resolution, sluggish mouse movement, limited clipboard sharing, and no seamless drag-and-drop between the host and guest. The tools also provide:

Better display drivers – allows resizing the VM window and using higher resolutions.
Mouse integration – lets the mouse move freely between host and guest without pressing Ctrl+Alt.
Time synchronization – keeps the guest clock in sync with the host.
VMware backdoor communication – enables features like vMotion and snapshots to work correctly.

While the guest OS will still boot without these tools, you will notice a degraded experience, especially with graphical interfaces.

Open-VM-Tools vs. VMware Tools

There are two main ways to get VMware Tools functionality on Ubuntu:

open-vm-tools – an open-source implementation included in the Linux kernel and available in Ubuntu’s repositories. It is the recommended method for most Linux distributions, including Ubuntu. It is easier to install, updates automatically with the system, and supports the latest kernel versions.
VMware Tools (proprietary) – the official VMware package that you install from an ISO image. This is sometimes needed for older VMware products or for features not yet in open-vm-tools, but it is generally not recommended for Ubuntu because it can lag behind kernel updates.

For most users, open-vm-tools is the best choice. It is actively maintained by the community and VMware, and it is the default in many enterprise Linux distributions.

Method 1: Install open-vm-tools (Recommended)

This method uses Ubuntu’s package manager, which is simpler and more reliable than the manual ISO method. Here are the steps:

Open a terminal in your Ubuntu guest (Ctrl+Alt+T).
Update the package list: sudo apt update
Install the tools: sudo apt install open-vm-tools
If you are using a desktop environment, also install open-vm-tools-desktop for features like clipboard sharing and drag-and-drop: sudo apt install open-vm-tools-desktop
Reboot the guest: sudo reboot

After reboot, check that the tools are running with systemctl status open-vm-tools or vmware-toolbox-cmd -v (if installed). If the service is active, you are good to go.

Method 2: Install VMware Tools from the ISO

If you prefer the official VMware Tools (or need it for a specific reason), follow these steps. This method is more involved and requires the VMware Tools ISO to be mounted.

In the VMware menu, go to VM > Install VMware Tools. This mounts the ISO as a CD-ROM in the guest.
Open a terminal and mount the CD-ROM (if not auto-mounted): sudo mount /dev/cdrom /mnt
Copy the tarball to your home directory (the filename may vary): cp /mnt/VMwareTools-*.tar.gz ~/
Extract it: tar -xzf VMwareTools-*.tar.gz
Change to the extracted directory: cd vmware-tools-distrib
Run the installer with root privileges: sudo ./vmware-install.pl
Follow the prompts. For most questions, pressing Enter to accept the default is fine. The installer will compile kernel modules, which requires the build-essential package and the Linux headers. If they are missing, the installer will tell you; you can install them with sudo apt install build-essential linux-headers-$(uname -r).
When the installation finishes, reboot the guest.

If the CD-ROM does not mount automatically, you may need to create the mount point and mount manually as shown above. Also, ensure that the ISO is attached to the VM (it is after step 1).

Common Problems and Fixes

Here are some frequent issues users encounter and how to resolve them:

Cannot resize the VM window – This usually means the tools are not running. Run sudo systemctl restart open-vm-tools or reboot the guest. If using the proprietary tools, check with vmware-toolbox-cmd.
Clipboard sharing not working – For open-vm-tools, you must install open-vm-tools-desktop and restart the session (log out and back in). Also, ensure that the VMware Workstation/Player preferences have clipboard sharing enabled.
Drag-and-drop fails – This is often fixed by the same steps as clipboard. If it still fails, try reinstalling the tools or upgrading VMware Workstation/Player to a newer version.
Kernel module compilation errors – When using the proprietary installer, you need the Linux headers and a C compiler. Run sudo apt install build-essential linux-headers-$(uname -r) and then rerun the installer.
Time drift – If the guest clock drifts, ensure the tools are running and enable time synchronization in the VM settings (VM > Settings > Options > Guest Operating System > VMware Tools > Time synchronization).

Verifying the Installation

After installation, you can verify that VMware Tools is working correctly. For open-vm-tools, run:

systemctl status open-vm-tools

It should show active (running). You can also run vmware-toolbox-cmd -v to see the version (if the toolbox is installed). For the proprietary tools, the command is the same. In VMware Workstation/Player, the status bar may also show a VMware Tools icon (a small monitor) that indicates the tools are running.

Frequently Asked Questions

Do I need VMware Tools for Ubuntu to work?

No, Ubuntu will run without it, but you will miss out on performance improvements, better graphics, and host-guest integration features. For a smooth experience, it is strongly recommended.

What is the difference between open-vm-tools and VMware Tools?

open-vm-tools is an open-source version that is included in Ubuntu’s repositories and is generally easier to install and update. The proprietary VMware Tools is the official package from VMware, but it is not recommended for Linux because it can lag behind kernel updates and may require manual recompilation.

Can I install VMware Tools on Ubuntu Server (no GUI)?

Yes, you can install open-vm-tools without the -desktop package. The core tools provide time sync, networking, and other services needed for server workloads.

Why does my mouse get stuck when I try to click?

This is often a sign that VMware Tools is not installed or not running. After installing the tools and rebooting, mouse integration should work seamlessly. If the problem persists, check the VMware Workstation/Player settings for mouse capture.

How do I uninstall VMware Tools?

For open-vm-tools, use sudo apt remove open-vm-tools open-vm-tools-desktop. For the proprietary tools, run sudo /usr/bin/vmware-uninstall-tools.pl as root.

Is it safe to install VMware Tools?

Yes, VMware Tools is a trusted component from VMware. open-vm-tools is also maintained by the open-source community. Both are safe to install on Ubuntu guests.

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →