# Parallels Tools for Linux

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

{% hint style="info" %}
**Note**: You may find the updated list of Linux distributives supported in Parallels Desktop on Apple Silicon Macs [here](https://kb.parallels.com/124223).
{% endhint %}

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 [KB article](https://kb.parallels.com/129740#section2).

### 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.

For more information on installing Parallels Tools, please refer to the [Parallels Knowledge Base](https://kb.parallels.com/).

### 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.parallels.com/landing/pdfm-ug/v19-en-us/parallels-desktop-for-mac-19-users-guide/advanced-topics/installing-and-updating-parallels-tools/parallels-tools-for-linux.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.