> 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?
#### **What requirements must be met?**
To install the sipgate app on a Linux desktop/laptop, some requirements must be met.
CPU: AMD / Intel or arm64\
OS: current OS
Download the appropriate installation file for your Linux here:\
[sipgate App Download](https://www.sipgate.de/app-download)\
Below you will find examples for the installation.
To start the sipgate app, follow these steps: Right-click the file **sipgate.AppImage** and select **Access permissions** off. There, enable the option **Run file as program**.
Then you can simply start the sipgate app by double-clicking the **sipgate.AppImage**-file.
#### Install the Deb file via 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 installation\
\- open the sipgate app and sign in
#### Install the Deb file via gdebi
* Execute the command **sudo apt-get install gdebi** .
* open sipgate.deb, then via right-click open “GDebi” and install
* Start the sipgate app via the sipgate app icon.\
If after installation a desktop shortcut is missing, run the following in the terminal: `xdg-desktop-menu install /usr/share/applications/sipgate-desktop.desktop`
#### Installation exception
There are some exceptions for installing the sipgate app that must be observed depending on the Linux distribution:
* For **Ubuntu 22.04/23.04** install the Fuse2 packages with the command "sudo apt install libfuse2" in the terminal console.
* For **Debian 10** there is a workaround to start the sipgate app without sandbox. To do this, open the terminal and enter the command **./sipgate-desktop --no-sandbox** in.
* Alternatively, with **Debian 10** on **Debian 11.5** update, in order to start the sipgate app normally.
#### Network installation of the sipgate app
We recommend using the app on the web: \
Users always have the current version and user rights 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 under “Extensions”, activate the sipgate App Click2Dial.\
In the sipgate app under Settings->Advanced, adjust 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 ensure that you receive notifications from the sipgate app on Linux, follow this path: Settings ➔ Notifications:\
\- do not disturb must not be active\
Settings ➔ Notifications: App notifications: sipgate app:\
\- notifications should already be enabled, otherwise enable them.
#### How do I get updates for the sipgate app on Linux?
When the app starts, the sipgate app automatically checks whether there is a new version. If so, it will be downloaded and installed immediately. This way, you always use the current version of the sipgate app.
{% hint style="warning" %}
Exception: On Debian 12.8 the automatic update does not work. Here, an update to Debian 12.9 must first be performed. Alternatively, the sipgate app can be uninstalled and reinstalled via the [website](https://www.sipgate.de/app-download) reinstalled.
{% endhint %}
#### How can I completely uninstall the app?
Via terminal uninstall the sipgate app: Enter the command **sudo apt remove sipgate-desktop** enter\
or uninstall the sipgate app via Snap Store/Software Center.\
After that, local configuration settings remain. To remove these, delete the following folder: /home/$Username/.config/sipgate-desktop
Errors & solutions (expandable)
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 Debian 10:** there is no folder **chrome-sandbox**\
**Solution Debian 10:** unclear\
**Workaround Debian 10:**\
Update to Debian 11.5, start sipgate app normally\
or start without sandbox via terminal: ./sipgate-desktop --no-sandbox
**Fedora 39>40 update**:\
Start via double-click: gets stuck on empty login window\
Start via terminal: Could not load window main: / Error: ERR\_FAILED\
**Cause**: Nouveau driver\
**Solution**: delete Nvidia driver, re-sign/install
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 Debian 10:** there is no folder **chrome-sandbox**\
**Solution Debian 10:** unclear\
**Workaround Debian 10:**
\- update to Debian 11.5, start sipgate app normally
\- or start without sandbox via terminal: ./sipgate-desktop --no-sandbox
**Error: Ubuntu 24.4.4 LTS Error: Cannot satisfy dependencies**
**Cause:** The error is not due to the CPU – the sipgate app runs on Intel and AMD. `amd64` is under Linux only the standard name for all 64-bit x86 CPUs.
Ubuntu 24.04 has renamed the system libraries (e.g. `libgtk-3-0`→`libgtk-3-0t64`). The package still requires the old names → error message. However, the libraries are present.
\
**Solution:**
* Recommended: use the sipgate app in the browser at [workspace.sipgate.com](http://workspace.sipgate.com) – no setup required.
* Alternatively (terminal): initiate installation manually:
```
sudo dpkg -i --force-depends /$PATH/sipgate-VERSION-amd64.deb
```
* Adjust the path to the file location (e.g.`~/Downloads/`). The sipgate app then starts normally.
---
# 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 current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.sipgate.de/cloud-telefonanlage/en/using-sipgate/die-sipgate-app/wie-installiere-ich-die-sipgate-app-unter-linux.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.