Parallels Tools manual installation

607 users found this article helpful


I am unable to install Parallels Tools through the virtual machine Mac menu bar: Actions (Virtual Machine in older versions) > Install Parallels Tools.

Resolution (Manual Installation)

Parallels Tools installation and /or updating is always required when you create a new virtual machine or upgrade Parallels Desktop to a newer build or version.

We also recommend reinstalling Parallels Tools when you are troubleshooting host-guest integration issues, such as Coherence, shared applications, shared folders, copy-and-pasting between your Mac and your virtual machine and mouse and keyboard issues.

If automatic installation does not start when expected (e.g., during an update to the Parallels Desktop build), or if you want to install Parallels Tools manually, follow the steps below.

Note: All examples pertain to Windows virtual machines.

Scenrio 1: Simple

  1. Start your virtual machine
  2. In the Mac menu click on Actions (Virtual Machine in older versions) > Install Parallels Tools (or Reinstall / Update Parallels Tools, if applicable)

  3. If the installation does not start, open the Start menu in Windows > Computer > Locate Parallels Tools CD drive. Then double-click on it to launch Parallels Tools installation.

  4. If the Parallels Tools installation has not started, right-click on Parallels Tools CD. Then choose Open, locate PTAgent.exe file and double-click on it to launch installation.

Scenario 2: More complicated

If the Parallels Tools disk image file is not mounted inside the virtual machine, meaning you cannot see the Parallels Tools CD in Windows Explorer under the Computermenu - follow these steps:

  1. Make sure your virtual machine is running in Window mode. If it is running in Coherence mode, exit Coherence.

  2. In Mac the menu click on Devices > CD/DVD > Connect image...

  3. In the Open window navigate to Applications > Parallels Desktop > Contents > Resources

  4. Inside the Resources folder, go to the Tools folder, and locate the file prl-tools-win.iso. Click on this file, then click the Open button

  5. Proceed with a manual Parallels Tools installation starting from Step 3 in Scenario 1, above.

Scenario 3: Most complicated

If the Parallels Tools image cannot be mounted inside Windows, and the steps above do not work (meaning Windows fails to recognize the CD/DVD disk attached to the virtual machine), follow these steps:

  1. Shut down your virtual machine.
  2. Locate your virtual machine in Finder see KB 117333.
  3. Right-click on your virtual machine’s .pvm file, then select Open with > Parallels Mounter.

  4. Your virtual machine's Hard Drives will be mounted in Finder:

  5. Locate the Windows hard disk containing the Windows installation — it will contain the Windows folder.

  6. Open a new Finder window and go to the Applications folder,
  7. Locate Parallels Desktop and right-click > Show Package Contents

  8. Go to Contents > Resources > Tools.
  9. Locate the prl-tools-win.tar.gz file and unarchive it. The resulting prl-tools-win folder will be extracted either to the same Tools folder or to the Downloads folder. You can also use Spotlight to locate the prl-tools-win folder.

  10. Copy the prl-tools-win folder to Windows hard drive mounted in Step 5

  11. Eject the Windows Hard Disks mounted in Finder

  12. Start your Windows virtual machine, open Windows Explorer and go to disk C:\

  13. Open the prl-tools-win folder and double-click on the setup.exe to start the Parallels Tools installation.

    Optionally you can go to the Data folder, open amd64 or i386 sub-folder according to your Windows architecture (64-bit or 32-bit); and run paralels-tools-amd64.exe or parallels-tools-i386.exe.

  14. Follow the Install wizard.


Was this article helpful?

Tell us how we can improve it.