> For the complete documentation index, see [llms.txt](https://docs.pascom.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pascom.net/en/operations/clients/linux-installation.md).

# Linux App Installation

How to install the PASCOM app on ubuntu linux

## Our recommendation: PASCOM Web App

We highly recommend using the [PASCOM Web App](https://pascom.cloud/app/beta/), which offers many benefits and can be installed as a desktop app via your browser.

The web app offers significant advantages over the classic installation:

* **Easy setup:** No need to install a separate program and no dependencies (like Pipewire) required depending on your Ubuntu version.
* **Better compatibility:** Independent of specific Linux distributions (Ubuntu Linux remains the officially tested version).
* **Extended headset support:** Benefit from broader HID device support (WebHID) directly in the browser.

## Install PASCOM Web App as a Chrome App

You can install the PASCOM Web App in Google Chrome. This allows it to act like a standalone desktop application and provides a clickable shortcut icon.

1. Open the PASCOM Web App in your Google Chrome browser.
2. Click the **Three-dot menu** (Customize and control Google Chrome) in the top right corner of the browser.
3. Navigate to **Save and share** and select **Install page as app...**.
4. Confirm the name in the new window and click **Install**.

{% hint style="info" %}
**Note on headset control (WebHID):**\
To answer calls via your headset using the Web App (WebHID) on Linux, you must still configure the UDEV rules in your system. Please refer to the UDEV configuration section below.
{% endhint %}

## Configure headsets and busylights (UDEV rules)

To ensure that the button control on your Jabra, Sennheiser, or Yealink headset, as well as Kuando Busylights, works smoothly on Linux (especially when using the Web App via WebHID), the corresponding UDEV rules must be added to your system.

Open your terminal and copy the entire code block below to automatically create the rules and reload the UDEV system:

```bash
cat <<EOF | sudo tee /etc/udev/rules.d/99-PASCOM-HID.rules > /dev/null
# Jabra Headset Support
ATTRS{idVendor}=="0b0e", MODE="0666"
# Sennheiser Headset Support
ATTRS{idVendor}=="1395", MODE="0666"
# Yealink Headset Support
ATTRS{idVendor}=="6993", MODE="0666"
# Kuando Busylight 1
SUBSYSTEM=="hidraw", ATTRS{idVendor}=="04d8", MODE="0666"
# Kuando Busylight 2
SUBSYSTEM=="hidraw", ATTRS{idVendor}=="27bb", MODE="0666"
EOF

sudo udevadm control --reload-rules && sudo udevadm trigger
```

***

## Classic installation

Follow the steps below to install the classic PASCOM app on Ubuntu Linux.

1. Download the [Linux Desktop App](https://my.pascom.net/update/client/cloud/linux).
2. Unpack **pascom\_Client.tar.bz2** in your home directory.
3. Create the Ubuntu Application Icon with **create-starter.sh**.
4. Start the PASCOM app via the Application Icon.

Example

```
tar jxvf ./Downloads/pascom_Client-7.17.10.R.tar.bz2
./pascom_Client/create-starter.sh 
```

If you use an X-Window session on Ubuntu 22.04, you must additionally install the following libraries:

```
sudo apt install libxcb-cursor-dev
```

#### Ubuntu 24.04 Audio

If you use Ubuntu 24.04 LTS, you must install the following additional libraries for audio to work:

```
apt install libasound2-plugins
```

#### Ubuntu 22.04 Audio

If you use Ubuntu 22.04 LTS and experience audio problems, you should use Pipewire instead of Pulseaudio. Here you can find detailed [instructions](/en/reference/howto/ubuntu-pipewire-audio.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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 following URL with the `ask` and `goal` query parameters:

```
GET https://docs.pascom.net/en/operations/clients/linux-installation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

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.