How to Install VMware Tools on Debian

In this article, I will discuss a Debian system that we installed with VMware Workstation. In fact, I will show you step by step how to install VM Tools on this virtual machine. I will also touch on the advantages that increase performance during the installation.

Thus, I have added screenshots to make the setup process easier. I also shared its commands with you so that you can easily optimize your virtual machine.

Installing VMware Tools in a Debian VM

How to Install VMware Tools on Debian 13 OS

If you are using the Workstation, you should do one more thing right after installing the operating system. You should definitely install VMware Tools on the virtual machine. This way, you will make your system work more appropriately with your host. You will also activate features such as file sharing and screen resolution.

VMware Tools help your virtual machine use hardware better. In fact, it works like a bridge between your real PC and the virtual system. So, it also makes everything faster and easier to use.

For example, you can change the display of your VM to full-screen mode. However, you can enable file sharing. You can move files between the host machine and your virtual system.

You can quickly drag and drop files from your physical PC to your virtual system. So, you can speed up file transfers and do your work more efficiently.

In addition, you can use USB 3.0 devices in your Debian VM. That is, you can use these devices directly.

Hardware support changes the whole virtual experience. Try setting up VMware Workstation on a Debian main host yourself. You will see a big gain in speed.

Installing VM Tools on a Debian Virtual Machine

Let’s say you installed Debian OS with VMware before. But you didn’t do anything else in your virtual system. So the first thing you’ll do is install the VM tools. Let’s follow the steps below and do the installation together!

1. Mount VMware Tools Image & Extract to Folder

Step 1

First, find your Debian VM system and open it. Then, from the tool menu, find VM > Install VMware Tools and press it.

Debian VMware Tools Screen

Step 2

On the screen that appears, double-click on the .tar.gz file.

VMTools.tar.gz Folder

Step 3

When you see the compressed folder with the tar extension, press Extract this time.

Extracting VMTools.tar.gz File

Step 4

On the Debian VM desktop, double-click on the Distrib folder to see it.

Viewing the Distrib Folder

2. Open Terminal in Distrib Folder & Install VMware Tools

Step 1

Let’s right-click on the folder to open the command tool on the Debian VM. At this point, we select the “Open in Terminal” option.

Open Terminal in Debian Virtual Machine

Step 2

Let’s start installing VMware Tools for the Debian VM. Now, on the command tool screen, apply the commands listed below in order.

su
Type your root password.
Look at the files in the folder with the “ls” command.
Execute the ./vmware-install.pl command.
Type Yes & press the Enter key to begin the setup.
Complete the VM Tools installation by answering the questions that will be asked again.

Installing Virtual Machine Tools in Debian

Step 3

Click Yes to keep installing the virtual machine drivers. Then, choose to install the binary files too.

Installing Binary Files

Step 4

We have successfully installed the drivers for the Debian virtual PC. Now let’s restart our virtual system with the command below.

shutdown -r now

Using the 'shutdown -r now' Command in Linux VM

Step 5

Finally, after rebooting, you can now start using your VM in full screen.

Sanal Makine Tam Ekran Modu

Related distros offer a similar desktop feel. Setting up guest tools on Ubuntu uses nearly the same packages. You get the same steps across both systems.

Troubleshooting Steps if VMware Tools Fails

At times, issues can happen even when you do the setup steps right. You might face problems when you try to install VMware Tools on your Debian virtual machine. Here are some steps to fix these common problems:

1. See If Your System Will Work With It

First, make sure your Debian version will work. This is for the VMware Tools you want to install. Always check the VMware guides for what works together.

2. Verify the VMware Tools Installation File

Next, make sure you downloaded the setup file correctly. Confirm that it isn’t damaged. If you think it is, reconnect the VMware Tools file. You can do this from the VMware menu by selecting VM > Reinstall VMware Tools.

3. Look at the Error Notes in the Terminal

When you run commands, look very carefully at the error notes. These notes often tell you what the problem is. Common issues can be missing parts or permission mistakes.

4. Make Sure You Have Installed the Necessary Packages

Some parts are needed for VMware Tools to work correctly. Make sure the required building tools and files are on your system. You can use this command:

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

This command installs the packages needed to compile the modules.

5. Run the Installation Script with Sudo

If you see a “not allowed” error, run the script with more power. Put “sudo” at the start of your command:

sudo ./vmware-install.pl

6. Check the Logs for Installation Errors

The VMware Tools setup notes can give you more details. Look at these notes. They are usually in the “/var/log/vmware-installer” folder.

Review these logs for error codes or messages that may help you troubleshoot the issue.

7. Restart the Debian Virtual Machine

Sometimes, a simple restart can fix setup problems. If you have tried many times, restarting your virtual machine might help.

8. Look for Community Solutions

If these steps do not fix your problem, look on the Internet. The VMware help groups are instrumental. Other people may have had the same problem, and their answers might help you.

By doing these steps, you can find and fix problems when you install VM Tools on your Debian machine. If you still have trouble, you should ask for help from the VMware support team.

Installing Debian Virtual Machine Drivers ⇒ Video

A video guide is also ready to show you how to put the VM program on Linux. Plus, if you find our video and article content helpful, consider subscribing to our YouTube channel. To be honest, this will motivate us even more and help us create valuable content!

Watch on YouTube

Debian VMware Tools FAQ

Which packages should I install for VMware Tools setup on Debian?

At its core, two main packages are enough on modern Debian systems. First comes open-vm-tools, which provides the core functions. Second is open-vm-tools-desktop, which completes the desktop experience.

Without the desktop package, features like clipboard sharing and screen resize go missing. If you only use the command line on the server side, open-vm-tools alone may be enough.

Frankly, there is also a chain of dependencies. If you want graphics acceleration or DKMS-based kernel modules, add the open-vm-tools-dkms package to the list too. The install command looks like this: sudo apt install open-vm-tools open-vm-tools-desktop.

My advice is to keep this trio on hand the moment you first set up the virtual machine. Noticing a missing feature later really annoys people.

What is the difference between open-vm-tools and the official driver set?

This split between the two is really a difference in mindset. open-vm-tools is VMware’s open-source app. The official driver set, though, is VMware’s own closed-source package.

VMware now suggests you use open-vm-tools for Linux. That’s because this package comes straight from the distro’s own repository. As a result, it stays in sync with kernel updates on its own.

The official set, however, needs a manual install from the ISO. It can bring the hassle of a rebuild with every kernel upgrade. On top of that, you may need to wait for VMware’s release schedule for security patches.

In short, open-vm-tools leads by a wide margin on Debian for community support and easy upkeep. Only consider the official set if you have a very specific compatibility case.

How do I fix the kernel headers not found error during setup?

This error usually shows up when you run the manual install script. The script looks for the header files to build the kernel modules and can’t find them.

The fix is really a one-line command. Type this into a terminal: sudo apt install linux-headers-$(uname -r) build-essential. This command loads both the headers for your current kernel and the compiler tools.

One key detail matters here. The $(uname -r) part grabs the version of the kernel that runs right now on its own. That way, you remove the risk of loading the wrong version headers.

If the error persists, refresh the package list. Sometimes the repo cache goes stale and the header package stays hidden.

Why does clipboard sharing fail after VMware Tools setup?

Clipboard sharing failure traces back to two main causes. First is a missing desktop package. Second is a session type mismatch.

If you didn’t install the open-vm-tools-desktop package, copy and paste stays off anyway. Even if you did install it, you may hit trouble in a Wayland session. People have reported clipboard issues with KDE Plasma Wayland on some Debian releases.

As a fix, try switching the session type to X11. On the login screen, pick X11 from the session option. This small change often kills the clipboard issue at the root.

Also, make sure the permissions are on in the VMware settings. Go to the Options tab in the virtual machine settings and check Clipboard sharing.

Do I need the extra component for screen resolution and copy-paste?

Absolutely, you need it. open-vm-tools alone gives you basic integration, but you need the desktop component for the visual side.

The open-vm-tools-desktop package brings VMware’s graphics drivers and guest session integration online. Without this package, your screen won’t fit the virtual machine window, and full-screen mode won’t work right.

Copy and paste depends on this component in the same way. Clipboard sharing, drag and drop, and auto resolution all run over the bridge this package provides.

In practice, think of it this way: open-vm-tools is the engine, and open-vm-tools-desktop is the steering wheel. A car won’t go without an engine, and you can’t steer without a wheel.

Should I install VMware Tools on Debian by hand or with the package manager?

I say this with no doubt: the package manager always wins. Save manual installs only for very special cases.

An install through APT handles dependencies for you. During kernel updates, the modules adapt on their own. Security patches follow the distro’s normal update cycle.

With a manual install, though, you must rerun the vmware-install.pl script on every new kernel. This script sometimes goes stale and clashes with the new kernel. Especially in a production setting, this creates a big headache.

VMware itself already points to open-vm-tools for Linux. So don’t take needless risks. Finish the job with the sudo apt install command.

What effect do guest tools have on virtual machine performance?

The effect is direct and easy to measure. Without guest tools, the virtual machine uses hardware resources poorly.

These tools provide special drivers for memory management and CPU scheduling. For example, the memory ballooning mechanism shares resources between host and guest in a smarter way. As a result, stalls drop.

The graphics side shows a big difference too. VMware’s graphics driver turns on 2D and 3D acceleration. Moving windows becomes smooth, and video playback gets easy.

Also think about the I/O side. Guest tools tune disk and network access. File copy speeds rise sharply. In short, these add-ons make the virtual machine feel like a real computer.

What do I do if the VMware Tools version and the kernel version don’t match?

This case usually shows up with manual installs or old packages. The kernel updates, but the tools stay old.

First, check the DKMS status. If the open-vm-tools-dkms package is in place, the kernel modules rebuild on their own. The package manager handles this job for you.

If the modules don’t load, check the state with the modprobe command. Check whether the vmw_vmci and vmwgfx modules load. When needed, run the sudo modprobe vmw_vmci vmwgfx command.

For a lasting fix, clean out the old manual install fully. After that, switch to the open-vm-tools packages. Keep the kernel headers current. This three-part mix removes the mismatch issue for the most part.

Is auto-update enough to keep the packages current?

Auto-update is a good start, but it’s not enough on its own. You need some extra checks on the virtual machine side.

APT’s unattended-upgrades mechanism pulls security patches on a regular basis. Still, when the kernel version jumps, the guest tool modules can sometimes fall behind. So don’t skip a system reboot after kernel updates.

Keep the VMware Workstation side current too. If the host software stays old, you can run into a compatibility issue with new guest tool versions.

My routine is this: once a month I run a full update on the virtual machine. Then I check the state of the vmtoolsd service. This small habit keeps big outages away.

How do I check the VMware Tools service on a Debian virtual machine?

The easiest way is to use the systemctl command. Type systemctl status vmtoolsd in a terminal. You see right away whether the service is active.

Service names can sometimes look different in the open-vm-tools package. The systemctl status open-vm-tools command does the job too. To see which unit runs, try the systemctl list-units | grep vm command.

If you just want to know if it’s there or not, the systemctl is-active vmtoolsd command gives a short reply. When the output says ‘active’, the service is up.

If the service isn’t running, start it first with sudo systemctl start vmtoolsd. To make it last, don’t forget the sudo systemctl enable vmtoolsd command. That way, the service comes on by itself at every boot.

Conclusion

To finish, putting VMware Tools on your Debian computer is essential. This will make it work better and be easier to use. Also, by following the steps in order, you can make your computer work its best.

For example, you get better screen pictures. Also, your file sharing gets better. You even use your USB devices in a better way. In the end, all these good things make the setup very useful.

Also, it is essential to know about everyday problems. This will help you fix setup issues. When you put VMware Tools on the right, you can use all the power of a virtual machine.

In short, you can know that your Debian virtual machine will do a lot more. This way, you make your VM into a helpful tool. By using all the good things this software gives, you can make your work much faster and better.

Would you like to optimize your virtual machine in Linux Mint as well? In that case, I recommend checking out our guide on “How to Install VMware Tools in Linux Mint.” First of all, it is similar to the installation I described for Debian. Once you apply it, you will be able to run your Mint VM smoothly and make it more efficient!

Cinnamon and MATE users follow the same steps. The logic is simple. The kernel structure is the exact same. Read our guide to install guest tools on Linux Mint.

How to Install VMware Tools in a Debian VM