LogoLogo
ProductsSupportDocumentation
English
English
  • Parallels Desktop for Mac 20 User's Guide
    • Welcome to Parallels Desktop
      • What You Can Do
      • Editions of Parallels Desktop
      • What's New in Parallels Desktop 20
      • What Versions of Windows You Can Install
      • Setting Up Your Mac to Use Windows Applications
      • Other Operating Systems
    • Install or Upgrade Parallels Desktop
      • System Requirements
      • Installing Parallels Desktop
      • Activating and Registering Parallels Desktop
      • Purchasing Parallels Desktop
      • Upgrading Parallels Desktop
        • Installing Software Updates
      • Changing the Language
    • Install or Import Windows
      • Installing Windows
      • Using Boot Camp with Parallels Desktop
      • Importing from an Earlier Version of Parallels Desktop or Another Virtualization Application
      • Downloading and Installing Windows from Microsoft
      • Getting Windows from IT
    • Use Windows on Your Mac
      • Getting Started
        • Launching Windows
        • Opening a Windows Application
        • Installing Windows Applications
        • Shutdown and Suspend Windows
          • Startup and Shutdown Settings
      • Setting How Windows Works with macOS
        • Merging Windows and macOS
        • Setting Windows to Appear in a Single Window
          • Adjusting Window Mode Settings
          • Monitoring Windows in a Scalable Window
        • Running Windows in Full-Screen Mode
          • Adjusting Full-Screen Settings
        • Setting an Application to Open When You Insert a CD/DVD
        • Sharing Items between macOS and Windows
          • Copying and Pasting between macOS and Windows
          • Sharing Files and Folders
          • Sharing iCloud, Dropbox, or Google Drive Folders with Windows
          • Sharing Windows OneDrive Folders with macOS
          • Sharing Applications
          • Setting Files to Open in Your Preferred Application
          • Setting Internet Links or Emails to Always Open in macOS or Windows
          • Opening the Current Safari Page in Microsoft Edge
          • Emailing macOS Files from Windows
          • Sharing External Storage Devices and Volumes
          • Sharing Windows External and Network Drives with macOS
          • Using a Disk Image with a Virtual Optical Drive
          • Adding Windows Disks to macOS Finder
      • Mouse, Trackpad, and Keyboard
        • Setting Your Mouse or Trackpad to Right-Click and Middle-Click
        • Using Keyboard Shortcuts
        • Customizing Keyboard Shortcuts
        • Creating New Keyboard Shortcuts
        • Controlling Windows Input Language In macOS
        • Mouse & Keyboard Settings
      • Connecting External Devices
        • Adjusting Device Settings
      • Connecting Bluetooth Devices
        • Connecting Bluetooth Game Controllers
      • Printing from Windows
        • Sharing a Printer Connected to Your Mac
        • Setting Up a Network Printer
        • Setting Up a USB Printer
      • Using the Built-in or External Webcam
      • Presenting on an External Display or Projector
      • Protecting Your Data
        • Isolating Windows from Mac
        • Working in Windows without Saving Changes
        • Setting Password Requirements
        • Using Apple Touch ID to Log into Windows
        • Encrypting Windows to Protect It from Unauthorized Use
      • Connecting to the Internet or a Network
        • Sharing Network Access Between macOS and Windows
        • Applying Separate Network Settings to Windows
        • Using Host-Only Network Settings
        • Using Wi-Fi with Windows
        • Connecting Windows to a VLAN
      • Optimizing Performance
        • Allocating Specific Amount of Memory to Windows
        • Optimization Settings
        • Pausing Windows When No Applications Are Open
        • Optimizing Virtual Machines for Specific Tasks
        • Scheduling Windows Maintenance
      • Saving Time with Parallels Toolbox
      • Saving a Screenshot from Windows
      • Setting the Appearance of Virtual Machine Dock Icons
      • Allowing Windows Updates While Your Mac is Sleeping
      • Translating Words in Windows
      • Using Apple Writing Tools in Windows
      • Using the Touch Bar in Windows
    • Parallels Desktop Preferences and Virtual Machine Settings
      • Parallels Desktop Preferences
        • General Preferences
        • Shortcuts Preferences
        • Devices Preferences
        • Security Preferences
        • Network Preferences
        • Advanced Preferences
        • Parallels Toolbox
      • Virtual Machine Settings
        • General Settings
        • Options
          • Startup and Shutdown Settings
          • Sharing Settings
          • Application Settings
          • Full Screen Settings
          • Picture in Picture Settings
          • Web & Email Settings
          • Maintenance Settings
          • More Options
        • Hardware Settings
          • CPU & Memory Settings
          • Graphics Settings
          • Mouse & Keyboard Settings
          • Shared Printers Settings
          • Network Settings
          • Sound & Camera Settings
          • USB & Bluetooth Settings
          • Hard Disk Settings
          • CD/DVD Settings
          • Boot Order Settings
          • TPM Chip
          • Printer Settings
          • Serial Port Settings
        • Security Settings
        • Backup Settings
      • Adding and Removing Devices
        • Support for Virtual and Physical Drives
        • Initializing a Newly Added Hard Drive
        • Connecting a Physical Disk to a Virtual Machine as Internal
    • Advanced Topics
      • Working with Virtual Machines
        • Supported Guest Operating Systems
        • About Virtual Machines
          • Set Where Virtual Machines Are Stored
        • Arranging Virtual Machines
        • Making Virtual Machines Distinctive
        • Changing the Virtual Machine Icon
        • Changing the Virtual Machine Name
        • Cloning a Virtual Machine
        • Backing Up a Virtual Machine
        • Creating and Using Virtual Machine Templates
        • Saving Snapshots of a Virtual Machine
        • Changing Virtual Machine Configuration While in Use
        • Scrolling Horizontally with a Mouse
        • Removing a Virtual Machine
        • Donwloading Pre-Configured Virtual Machines
        • Setting Guest OS Type and Version
        • Changing the Number of Virtual CPUs Allocated to a Virtual Machine
        • Using Apple Script with the Guest OS
        • Freeing Up Disk Space
        • Archiving/Unarchiving Virtual Machines
        • Transfering a Virtual Machine to Another Mac
        • Importing and Running x86_64 (Intel) Virtual Machines on Apple Silicon Macs
          • Launching and Running an x86_64 Virtual Machine on an Apple Silicon Mac
          • Creating a New x86_64 (Intel) Virtual Machine on an Apple Silicon Mac
      • Using Other Operating Systems on Your Mac
        • Customizing the Keyboard for a Guest OS
        • Running macOS Virtual Machines
          • Signing into Apple Account on macOS Virtual Machines
          • Connecting USB Devices Directly to Your macOS Virtual Machine
          • Supported Trackpad Gestures
      • Installing and Updating Parallels Tools
        • Parallels Tools Overview
        • Parallels Tools for Windows
        • Parallels Tools for Linux
        • Parallels Tools for Mac
      • Setting File Type Associations
      • Picture in Picture Mode
      • Hiding and Showing Parallels Desktop
      • Removing Parallels Desktop
      • Advanced Settings
      • Shared Network Settings
      • Host-Only Network Settings
      • Creating Custom Host-Only Networks
    • Troubleshooting
    • Parallels Desktop Social Media Pages
    • More Resources
    • Glossary
Powered by GitBook

© 2025 Parallels International GmbH. All rights reserved.

On this page
  • How to install Parallels Tools using Terminal
  • How to Ensure Parallels Tools Have Been Installed
  • Troubleshooting
  • Updating Parallels Tools
  • Reinstalling Parallels Tools

Was this helpful?

Export as PDF
  1. Parallels Desktop for Mac 20 User's Guide
  2. Advanced Topics
  3. Installing and Updating Parallels Tools

Parallels Tools for Linux

PreviousParallels Tools for WindowsNextParallels Tools for Mac

Last updated 1 year ago

Was this helpful?

If you chose Express Installation when you first installed Linux, Parallels Tools were installed automatically after the installation.

Note: You may find the updated list of Linux distributives supported in Parallels Desktop on Apple Silicon Macs .

If you didn't choose Express Installation, do the following to install Parallels Tools:

  1. Launch the Linux virtual machine.

  2. When it boots up, connect the Parallels Tools image to the virtual machine: in the menu bar, click Devices > CD/DVD > Connect image....

  3. Browse to the image location Application > Parallels Desktop.app > Contents > Resources > Tools > select prl-tools-lin-arm.iso if your Mac runs on Apple silicon or prl-tools-lin.iso for Intel Macs. This will mount a virtual CD/DVD with the Parallels Tools.

  4. Double-click on the install-gui file to start the installation.

  5. When the installation is complete, click Restart to restart the virtual machine or wait for it to restart automatically.

How to install Parallels Tools using Terminal

The details on installing Parallels Tools for Linux using Terminal are maintained and updated in this .

How to Ensure Parallels Tools Have Been Installed

You can easily confirm whether Parallels Tools were installed. Start your virtual machine and look at the status bar of its window. If the tip "Press Ctrl + Alt to release the mouse and keyboard" appears in the status bar of the virtual machine's window, this means that Parallels Tools were not installed. When Parallels Tools are installed, you do not need to press any key to release the mouse and keyboard - they are released automatically.

Troubleshooting

Parallels Tools may fail to install because not all mandatory packages are available. Check the /var/log/parallels-tools-install.log file in the guest OS for error messages, install the missing packages, and try to install Parallels Tools again.

Updating Parallels Tools

When a newer version of Parallels Tools for Linux becomes available, the Parallels Tools Installation Agent window will appear. You will be prompted to choose the command to gain root privileges and enter the password (if su - root password, if sudo - your user's password). After that, Parallels Tools update automatically.

Reinstalling Parallels Tools

To reinstall Parallels Tools in Linux, remove them first and install them once again.

For more information on installing Parallels Tools, please refer to the .

here
KB article
Parallels Knowledge Base