← Blog
November 24, 2025

Debian on VMware: Install Debian 13 and open-vm-tools

To run Debian in VMware today, create a Debian 13 virtual machine and install open-vm-tools from Debian’s repositories. Add open-vm-tools-desktop only when the guest has a graphical desktop. Broadcom recommends open-vm-tools for current Debian guests, and Debian delivers its updates through the normal package manager.

This guide covers the common case first: installing Debian as a guest in VMware Workstation on an Intel or AMD host. A shorter section explains what changes when Debian is the host operating system. Apple Silicon Macs require an arm64 guest and VMware Fusion, so they follow a different architecture path.

Debian and VMware compatibility in 2026

Debian 13, codenamed trixie, is the current stable release. Debian 13.6 was released on July 11, 2026. Broadcom’s current VMware Workstation host compatibility table lists Debian 13.x for Workstation 26H1 and Debian 12.x for Workstation 25H2 and 26H1.

That host matrix matters only if you plan to install VMware Workstation on Debian itself. If Debian is the guest operating system inside Workstation on Windows or Linux, use the guest type that matches the ISO architecture. Most Intel and AMD computers need the Debian amd64 image. Apple Silicon needs arm64 and Fusion; the VMware Fusion guide for Apple Silicon explains that constraint.

What you need

  • A 64-bit Intel or AMD host with hardware virtualization enabled for the amd64 path
  • A current VMware Workstation release from the Broadcom Support Portal
  • The official Debian 13 amd64 netinst ISO
  • Enough host memory and disk space for both the host and the guest

For a general desktop VM, 2 virtual CPUs, 4 GB of RAM, and 40 GB of virtual disk space are a sensible starting point rather than official minimums. A command-line server can use less; compilers, databases, or desktop applications may need more. Keep enough resources free for the host.

1. Download VMware Workstation and Debian

Download Workstation from Broadcom’s current portal instead of copying an old bundle filename from a tutorial. Broadcom’s desktop hypervisor download instructions explain the account and export-compliance steps and direct users to select the latest available Workstation release.

VMware Workstation Pro is free for personal, educational, and commercial users. Current free releases do not require a license key. This replaces the old trial-and-paid-license model described in earlier Workstation guides.

Get Debian from the official Debian download page. For a conventional Intel or AMD workstation, choose the amd64 netinst ISO and download the checksum and signature from the same page. Do not use an arm64 ISO merely because the host CPU brand includes “64”; arm64 is for ARM hardware.

2. Create the Debian virtual machine

  1. Open VMware Workstation and choose to create a new virtual machine.
  2. Select the Debian 13 amd64 ISO as the installer image.
  3. Choose Debian 13 64-bit when that guest option is available. If the exact label is missing, select the closest current 64-bit Debian or generic Linux option listed by that Workstation release.
  4. Give the VM a clear name and choose where its files will live.
  5. Allocate CPU, memory, and virtual disk capacity for the workload, while leaving enough resources for the host.
  6. Use NAT for the simplest network setup. Choose bridged networking only when the VM must appear as a separate device on the local network.
  7. Start the VM and boot from the ISO.

The Debian 13 installation guide is the authority for installer choices. The graphical installer is usually the easiest path. Select a desktop environment only if the guest needs a GUI; a server or terminal-only lab can remain smaller.

After the first boot, remove or disconnect the installer ISO if Workstation has not done so automatically. Then update Debian:

sudo apt update
sudo apt full-upgrade

Reboot if the upgrade installs a new kernel.

3. Install VMware Tools on Debian with open-vm-tools

Do not mount the legacy VMware Tools ISO or run the old Perl installer on a current Debian guest. Broadcom’s VMware Tools compatibility guidance recommends open-vm-tools for Debian 11 and later. Debian maintains the package and delivers fixes through its own update lifecycle.

Headless or server guest

sudo apt update
sudo apt install open-vm-tools
sudo systemctl enable --now open-vm-tools

Desktop guest

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

The core open-vm-tools package supplies the command-line guest services. The desktop package adds graphical integration such as display resizing and desktop copy-and-paste support. Installing the desktop package on a server adds graphical dependencies without helping a headless workload.

Verify the service

systemctl status open-vm-tools --no-pager
vmware-toolbox-cmd -v

The service should report an active state. The version command should return the installed tools version. Use Debian’s packaged version unless a specific support case requires something else.

4. Configure desktop integration and shared folders

Automatic display resizing normally starts after open-vm-tools-desktop is installed and the guest has rebooted. Copy-and-paste and drag-and-drop depend on the desktop session as well as the package. Broadcom notes that these functions do not currently work with Wayland in this Workstation and Fusion workflow. If they are essential, sign in with an X11 session and test again.

For shared folders, enable the folder in the VM’s Workstation settings first. Recent tools normally mount enabled shares below /mnt/hgfs. Check with:

ls -la /mnt/hgfs

If the directory is empty, confirm that the share is enabled and that open-vm-tools is current. Broadcom documents both the current Linux shared-folder behavior and a systemd mount procedure for systems where automatic mounting is unavailable. Do not add a custom mount unit until the basic package, VM setting, and default mount have been checked.

5. Troubleshoot the common failures

open-vm-tools is installed but the service is not active

sudo systemctl restart open-vm-tools
sudo journalctl -u open-vm-tools -b --no-pager

The journal output is more useful than reinstalling the package repeatedly. Apply pending Debian updates and reboot before treating an old boot error as current.

The desktop does not resize

Confirm that open-vm-tools-desktop is installed, then reboot the guest. Check whether the session is Wayland or X11:

echo $XDG_SESSION_TYPE

Display resizing can work while clipboard or drag-and-drop integration remains limited by the session type, so test each feature separately.

There is no network connection

Start with NAT and confirm the virtual network adapter is connected in Workstation. Inside Debian, inspect the assigned interfaces and route:

ip address
ip route

If NAT works but bridged mode does not, the problem is usually in the host’s bridge selection, Wi-Fi restrictions, or local network policy rather than Debian’s installer.

Shared folders are missing

Check the Workstation share setting, the /mnt/hgfs directory, and the tools service. Use Broadcom’s documented vmhgfs-fuse approach only when the default behavior does not mount the share.

Install VMware Workstation on a Debian host

This is a different task from installing Debian as a guest. Check Broadcom’s host compatibility table before downloading because support is tied to specific Workstation, Debian, and kernel combinations. The current table lists Debian 13.x with Workstation 26H1.

Install the compiler and headers that match the running kernel:

sudo apt update
sudo apt install build-essential linux-headers-$(uname -r)

Download the current Linux bundle from Broadcom, make that exact file executable, and run it with administrator privileges:

chmod +x VMware-Workstation-Full-<version>.bundle
sudo ./VMware-Workstation-Full-<version>.bundle

Replace <version> with the filename you downloaded. Avoid hardcoding Workstation 17.6.3 or a specific GCC package into a reusable guide. New Workstation and Debian releases change the supported versions, and the matching kernel headers matter more than a copied compiler number.

If Workstation fails after a Debian kernel update, first confirm that headers for the running kernel are installed. Then let Workstation rebuild its host modules. Host-side vmmon and vmnet are unrelated to open-vm-tools inside a Debian guest.

Local Debian VM or cloud VM?

A local VMware VM is a good fit for learning, offline testing, snapshots, and work that should remain on one computer. It uses the host’s CPU, memory, storage, and battery, so several long-running VMs can become inconvenient.

A cloud VM is useful when an environment must run independently of the laptop, remain reachable remotely, or use more resources than the local host can spare. The Ubuntu, Debian, and Fedora cloud VM comparison can help with the operating-system choice. If the workload has outgrown a desktop hypervisor, review Hivenet Compute as one available remote-compute path.

Frequently asked questions

Should I install VMware Tools or open-vm-tools on Debian?

Install open-vm-tools from Debian’s repository. Add open-vm-tools-desktop for a graphical guest. Broadcom recommends this route for current Debian releases.

Does Debian 13 work with VMware Workstation?

Yes. Broadcom’s current host matrix lists Debian 13.x with Workstation 26H1. Debian 13 also works as a guest when the Workstation release and selected guest architecture are compatible.

Is VMware Workstation Pro free?

Yes. Broadcom states that current Workstation Pro releases are free for personal, educational, and commercial use and do not require a license key.

Why does copy and paste fail in my Debian VM?

Confirm that open-vm-tools-desktop is installed. Broadcom’s current guidance says Workstation and Fusion drag-and-drop and copy-and-paste integration does not work with Wayland, so test an X11 session when those features are required.

Can I use a Debian arm64 ISO in VMware Workstation on an Intel PC?

No. Use the amd64 ISO for a normal Intel or AMD Workstation host. Use arm64 for an ARM virtualization path such as VMware Fusion on Apple Silicon.

Next steps

Download the current Debian ISO, create the VM, complete the base installation, and add the appropriate open-vm-tools package. Verify the service before changing advanced integration settings. If a feature fails, separate guest-tool issues from host-module, network, or desktop-session problems before troubleshooting.

Your next workload belongs on Hivenet.

Pick one AI, compute, or storage workload and see the difference for yourself. Spin it up in minutes, or let our team map your fastest path to production.

Shader gradient background