How to Install Open VM Tools on Debian 13, 12 and 11

Debian VMware guests need the guest tools before console resizing, clipboard sharing, drag-and-drop, and shared folders behave like an integrated VMware guest. To install VMware Tools on Debian 13 (trixie), Debian 12 (bookworm), or Debian 11 (bullseye), use Debian’s open-vm-tools packages instead of the older mounted ISO installer.

Use open-vm-tools-desktop for graphical guests and open-vm-tools for server or headless guests. The desktop package depends on the base daemon package, and both come from Debian’s default repositories with APT-managed updates, so normal installs do not need a manual VMware Tools download.

Open-VM Tools is only for Debian guests running on VMware platforms such as VMware Workstation, VMware Fusion, VMware Player, or VMware ESXi. VirtualBox, QEMU/KVM, Hyper-V, and other hypervisors use different guest tools.

Install Open-VM Tools on Debian

Update Debian Packages

Refresh package metadata and review available upgrades before installing the VMware guest packages. APT shows the packages it will upgrade before asking for confirmation.

sudo apt update
sudo apt upgrade

These commands use sudo for administrative tasks. If your account cannot run sudo yet, use a root shell or add the user to sudoers on Debian before continuing.

Confirm Debian Is Running on VMware

Check the detected virtualization platform before installing Open-VM Tools. The service unit included with Debian’s package only starts when systemd detects VMware virtualization.

systemd-detect-virt

A VMware guest should return:

vmware

If the command returns oracle, kvm, microsoft, or another platform name, use the guest-tools package for that platform instead of installing Open-VM Tools.

Choose the Correct Open-VM Tools Package

Choose one package path based on the Debian guest you are running. The desktop package depends on the base package, so desktop users do not need to install both separately.

Package	Use Case	What It Adds
open-vm-tools-desktop	Debian desktop guests	Base VMware daemon plus clipboard, drag-and-drop, and display integration for graphical sessions
open-vm-tools	Debian server or headless guests	Core vmtoolsd service, time sync, guest information, power operations, and shared-folder helpers
open-vm-tools-dev	Development only	Headers and development files for compiling against Open-VM Tools libraries

Install Open-VM Tools for Debian Desktop

Install open-vm-tools-desktop on Debian guests with GNOME, KDE Plasma, Xfce, Cinnamon, or another graphical desktop environment:

sudo apt install open-vm-tools-desktop

This package also installs the base open-vm-tools package, so it covers both the VMware daemon and the desktop integration layer.

Install Open-VM Tools for Debian Server

Install the smaller base package on Debian server, minimal, or headless VMware guests that do not run a graphical desktop:

sudo apt install open-vm-tools

Install Development Headers (Optional)

Most users should skip the development package. Install open-vm-tools-dev only when you are building software against the Open-VM Tools project libraries or headers.

sudo apt install open-vm-tools-dev

A matching ii line confirms the optional development package is installed:

dpkg-query -W -f='${db:Status-Abbrev} ${binary:Package}\n' open-vm-tools-dev | grep '^ii'

Reboot Debian After Installation

Reboot after the first install so the VMware service, desktop session, and shared-folder helpers start from a clean guest session:

sudo reboot

Verify Open-VM Tools on Debian

Check the Installed Package Version

After the reboot, confirm that the base package is installed. This check works for both desktop and server installs because open-vm-tools-desktop depends on open-vm-tools.

apt-cache policy open-vm-tools

On Debian 13 (trixie), relevant output includes:

open-vm-tools:
  Installed: 2:12.5.0-2+deb13u1
  Candidate: 2:12.5.0-2+deb13u1
  Version table:
 *** 2:12.5.0-2+deb13u1 500
        500 http://deb.debian.org/debian trixie/main amd64 Packages

Debian 12 (bookworm) and Debian 11 (bullseye) show release-specific package revisions, and Bullseye may show the security pocket as the active source. The exact revision can change with Debian security updates, so the important part is that Installed: shows a package version instead of (none).

Check the VMware Tools Service

Check that the open-vm-tools.service unit is active and enabled. In a VMware guest, this service runs the vmtoolsd daemon.

systemctl is-active open-vm-tools
systemctl is-enabled open-vm-tools

Expected output:

active
enabled

Use the full status view when you need the unit path or recent service messages:

systemctl status open-vm-tools --no-pager

Debian 13 stores the unit under /usr/lib/systemd/system/open-vm-tools.service, while Debian 12 and Debian 11 may show /lib/systemd/system/open-vm-tools.service. That path difference is normal; the service name remains open-vm-tools.service, and the unit includes ConditionVirtualization=vmware.

Confirm Desktop Integration Package

If you installed the desktop package, confirm that Debian records it as installed:

dpkg-query -W -f='${db:Status-Abbrev} ${binary:Package}\n' open-vm-tools-desktop | grep '^ii'

Expected output:

ii  open-vm-tools-desktop

Troubleshoot Open-VM Tools on Debian

Most Open-VM Tools problems come from the wrong virtualization platform, missing desktop components, or VMware host settings that are disabled outside Debian.

Service Is Skipped or Inactive

Debian’s service unit includes ConditionVirtualization=vmware. If the VM is running under VirtualBox, QEMU/KVM, Hyper-V, or another hypervisor, the service can stay inactive because the VMware condition is not met.

systemd-detect-virt
systemctl status open-vm-tools --no-pager

If systemd-detect-virt does not return vmware, install the guest tools for the detected platform instead of forcing the Open-VM Tools service to start.

Clipboard, Drag-and-Drop, or Resize Does Not Work

Clipboard sharing, drag-and-drop, and automatic display resizing need the desktop package plus an active graphical session. Confirm that open-vm-tools-desktop is installed first:

dpkg-query -W -f='${db:Status-Abbrev} ${binary:Package}\n' open-vm-tools-desktop | grep '^ii'

If the package is missing, install it and reboot the Debian guest:

sudo apt install open-vm-tools-desktop
sudo reboot

If the package is installed but desktop features still fail, confirm the per-user VMware Tools process is running inside the graphical session:

pgrep -a -u "$USER" -f '[v]mtoolsd -n vmusr'

A matching line that includes /usr/bin/vmtoolsd -n vmusr means the VMware User Agent is running for your session. If no line appears, sign out and back in, or reboot the guest. If the process is running but desktop features still fail, check the VMware host settings for guest isolation, clipboard sharing, drag-and-drop, and shared-folder options. Debian cannot enable those host-side controls from inside the guest.

Shared Folders Do Not Appear

Open-VM Tools includes vmware-hgfsclient and vmhgfs-fuse for VMware shared folders. List shares exposed by the host with this command:

vmware-hgfsclient

If no share names appear, enable shared folders in the VMware VM settings first. If share names do appear but mounting still fails, verify that the open-vm-tools package is installed and the VMware Tools service is active:

dpkg-query -W -f='${db:Status-Abbrev} ${binary:Package}\n' open-vm-tools | grep '^ii'
systemctl is-active open-vm-tools

The package check should return an ii line for open-vm-tools, and the service check should return active. If the service is inactive, use the service troubleshooting steps before changing shared-folder mount settings.

Features Stop After a Kernel Update

Debian’s Open-VM Tools package is not a DKMS workflow that rebuilds VMware modules after every kernel update. The Linux kernel already carries the normal VMware guest drivers, while vmhgfs-fuse handles shared folders in user space. Reboot into the new kernel first, then check the service again.

sudo reboot

If package files look damaged after the reboot, reinstall only the package path you use:

sudo apt reinstall open-vm-tools

For desktop guests, reinstall the desktop package as well:

sudo apt reinstall open-vm-tools-desktop

After reinstalling, retest the service before chasing VMware host settings or desktop-session behavior:

systemctl is-active open-vm-tools

The command should return active. For desktop-only symptoms, also rerun the per-user VMware User Agent check after signing back in.

Update or Remove Open-VM Tools

Update Open-VM Tools

Open-VM Tools updates through Debian’s normal package manager. For the base package, use:

sudo apt update
sudo apt install --only-upgrade open-vm-tools

For desktop guests, include the desktop package in the upgrade request:

sudo apt update
sudo apt install --only-upgrade open-vm-tools open-vm-tools-desktop

If you installed the development headers, upgrade that package with the same targeted pattern:

sudo apt update
sudo apt install --only-upgrade open-vm-tools-dev

Remove Open-VM Tools

Removing Open-VM Tools disables VMware guest integration, including clipboard sharing, display resizing, drag-and-drop file transfers, shared-folder helpers, guest power operations, and time synchronization. Remove these packages only when the Debian VM no longer runs on VMware or you are switching to another hypervisor.

Remove the Open-VM Tools packages you installed. APT skips package names that are not present, so this command is safe for desktop, server, and development-package installs:

sudo apt remove --purge open-vm-tools open-vm-tools-desktop open-vm-tools-dev

Then review unused dependencies before accepting the autoremove prompt. Do not approve the removal list if it includes unrelated kernels, desktop task packages, database packages, or other software you still need.

sudo apt autoremove --purge

Confirm no Open-VM Tools package remains installed. No output means the listed packages are no longer in the installed state:

dpkg-query -W -f='${db:Status-Abbrev} ${binary:Package}\n' open-vm-tools open-vm-tools-desktop open-vm-tools-dev 2>/dev/null | grep '^ii'

The purge step removes package-managed configuration under /etc/vmware-tools/. Open-VM Tools does not create a normal user-profile data directory, but shared-folder mounts or custom scripts you created manually should be removed separately if they are no longer needed.

Conclusion

Open-VM Tools is installed from Debian’s repositories, and open-vm-tools.service is active inside the VMware guest. Desktop guests also have the VMware User Agent path for clipboard, drag-and-drop, and display resizing. For remote administration, add SSH access on Debian so the guest stays reachable when the VMware console is unavailable.