> For the complete documentation index, see [llms.txt](https://help.sipgate.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sipgate.de/cloud-telefonanlage/en/using-sipgate/die-sipgate-app/wie-installiere-ich-die-sipgate-app-unter-linux.md).

# How do I install the sipgate app on Linux?

Instructions for using the sipgate app on Linux – directly in the browser without separate installation.

#### **What are the requirements?**

To install the sipgate app on a Linux desktop or laptop, you need to meet a few requirements.

CPU: AMD / Intel or arm64\
OS: Current OS

Download the appropriate installation file for your Linux system here:\
[sipgate app download](https://www.sipgate.de/app-download)\
Below are some examples of how to install it.

To start the sipgate app, follow these steps: Right-click the file **sipgate.AppImage** and select **Permissions** out. There, enable the option **Allow executing file as a program**.

You can then launch the sipgate app simply by double-clicking the **sipgate.AppImage**file.

#### Install the DEB file via the Snap Store

\- download the appropriate application: [sipgate app download](https://www.sipgate.de/app-download)\
Example: Ubuntu + AMD CPU: sipgate-amd64.deb\
\- double-click the file and start the installation\
\- open the sipgate app and sign in

#### Install the DEB file using gdebi

* Run the command **sudo apt-get install gdebi** to
* then right-click sipgate.deb, choose “Open with GDebi,” and install it
* Launch the sipgate app using the sipgate app icon.\
  If a desktop shortcut is missing after installation, run the following command in a terminal: `xdg-desktop-menu install /usr/share/applications/sipgate-desktop.desktop`

#### Installation exceptions

There are a few exceptions to keep in mind when installing the sipgate app, depending on your Linux distribution:

* For **Ubuntu 22.04/23.04** Install the Fuse2 packages by running the command "sudo apt install libfuse2" in the terminal.
* On **Debian 10** there is a workaround for launching the sipgate app without a sandbox. To do this, open the terminal and enter the command **./sipgate-desktop --no-sandbox** .
* Alternatively, on **Debian 10** you can upgrade to **Debian 11.5** update to start the sipgate app normally.

#### Network installation of the sipgate app

We recommend using the app on the web: <http://workspace.sipgate.com/>\
Users always have the latest version, and user permissions are sufficient.

{% hint style="info" %}
**Note**: Local administrator rights are required to install or update the sipgate app.
{% endhint %}

#### sipgate app + Click2Dial Chrome Extension / Click2Dial tel:

The sipgate app Click2Dial can be found in the Chrome Web Store [here](https://chromewebstore.google.com/detail/sipgate-app-click2dial/meocbidedjibjdlhfjgplpogklmbhbko) and can be installed in Chrome-based browsers.\
In the browser, enable the sipgate app Click2Dial under “Extensions.”\
In the sipgate app, go to Settings->Advanced to configure how Click2Dial should be used. Link [FAQ](https://help.sipgate.de/hc/de/articles/18011131409181-Wie-richte-ich-die-Chrome-Erweiterung-in-der-sipgate-App-CLINQ-ein)

#### Enable notifications for the sipgate app

To make sure you receive notifications from the sipgate App on Linux, follow this path: Settings ➔ Notifications:\
\- Do not disturb must not be enabled\
Settings ➔ Notifications: Application Notifications: sipgate App:\
\- Notifications should already be enabled; if not, enable them.

![image.png](https://4045603198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg0qj71PeONPljdPedXLf%2Fuploads%2Fgit-blob-d62e9aeb818e6a557425d63c15afc867b5e95b0c%2Fimage.png?alt=media\&token=a7fa08ef-9882-44ce-a0c6-c131271a8586)

![](https://4045603198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg0qj71PeONPljdPedXLf%2Fuploads%2Fgit-blob-4f452effe3f5cf1b6f83517c48d0c41d10923c61%2Fmceclip1.png?alt=media\&token=f46f3e19-8588-4a8d-bc44-40d492f196d4)

#### How do I get updates for the sipgate App on Linux?

When the app starts, the sipgate App automatically checks whether a new version is available. If so, it will download and install it immediately. This ensures that you always use the latest version of the sipgate App.

{% hint style="warning" %}
Exception: Automatic updates do not work on Debian 12.8. You must update to Debian 12.9 first. Alternatively, you can uninstall the sipgate App and reinstall it from the [website](https://www.sipgate.de/app-download) .
{% endhint %}

#### How can I completely uninstall the app?

Uninstall the sipgate App via the terminal: Enter the command **sudo apt remove sipgate-desktop** \
or uninstall the sipgate App via the Snap Store/Software Center.\
Local configuration settings will remain. To remove them, delete the following folder: /home/$Username/.config/sipgate-desktop

<details open>

<summary>Errors &#x26; solutions (expandable)</summary>

Error message when starting the app in the terminal: **FATAL:setuid\_sandbox\_host.cc(157)] The SUID sandbox helper binary was found, but is not configured correctly. Rather than run without sandboxing I'm aborting now. You need to make sure that /tmp/.mount\_sipgatkaQrRB/chrome-sandbox is owned by root and has mode 4755**

**Cause on Debian 10:** there is no **chrome-sandbox**\
**Solution for Debian 10:** unclear\
**Workaround for Debian 10:**\
Update to Debian 11.5 and start the sipgate App normally\
or start it without the sandbox via the terminal: ./sipgate-desktop --no-sandbox

**Fedora 39>40 update**:\
Starting with a double-click: hangs with a blank login window\
Starting via the terminal: Could not load window main: / Error: ERR\_FAILED\
**Cause**: Nouveau driver\
**Solution**: Remove, re-sign, and reinstall the Nvidia driver

Error message when starting the app in the terminal: **FATAL:setuid\_sandbox\_host.cc(157)] The SUID sandbox helper binary was found, but is not configured correctly. Rather than run without sandboxing I'm aborting now. You need to make sure that /tmp/.mount\_sipgatkaQrRB/chrome-sandbox is owned by root and has mode 4755**

**Cause on Debian 10:** there is no **chrome-sandbox**\
**Solution for Debian 10:** unclear\
**Workaround for Debian 10:**

\- Update to Debian 11.5 and start the sipgate App normally

\- or start it without the sandbox via the terminal: ./sipgate-desktop --no-sandbox

**Error: Ubuntu 24.4.4 LTS Error: Cannot satisfy dependencies**<br>

**Cause:** The error is not related to the CPU—the sipgate App runs on Intel and AMD. `amd64` is simply the standard name for all 64-bit x86 CPUs on Linux.

Ubuntu 24.04 renamed the system libraries (e.g., `libgtk-3-0`→`libgtk-3-0t64`). The package still requires the old names, resulting in an error. However, the libraries are present.

\
**Solution:**

* Recommended: Use the sipgate App in your browser at [workspace.sipgate.com](http://workspace.sipgate.com) — no setup required.
* Alternatively (terminal): Start the installation manually:

```
sudo dpkg -i --force-depends /$PATH/sipgate-VERSION-amd64.deb
```

* Adjust the path to the file’s location (e.g.`~/Downloads/`). The sipgate app will then start normally.

</details>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.sipgate.de/cloud-telefonanlage/en/using-sipgate/die-sipgate-app/wie-installiere-ich-die-sipgate-app-unter-linux.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 `automate deployments from our CI pipeline` 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.
