> 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 a separate installation.
#### **What prerequisites must be met?**
To install the sipgate App on a Linux desktop/laptop, some prerequisites 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 of the installation.
To start the sipgate App, follow these steps: Right-click the file **sipgate.AppImage** and select **Access permissions** there. There, enable the option **Run file as program**.
You can then start the sipgate App simply 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 log in
#### Install the deb file via gdebi
* Run the command **sudo apt-get install gdebi** execute it
* open sipgate.deb then via right-click, choose “Open with GDebi,” and install
* Use the sipgate App icon to start the sipgate App.\
If a desktop shortcut is missing after installation, run the following in the terminal: `xdg-desktop-menu install /usr/share/applications/sipgate-desktop.desktop`
#### Installation exception
There are a few 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.
* On **Debian 10** there is a workaround to start the sipgate App without sandboxing. To do this, open the terminal and enter the command **./sipgate-desktop --no-sandbox** .
* Alternatively, for **Debian 10** 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: \
Users always have the current 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:
You can find the sipgate App Click2Dial 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,” enable 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 make sure 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. An update to Debian 12.9 must be performed first. 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?
Uninstall the sipgate App via terminal: Enter the command **sudo apt remove sipgate-desktop** enter\
or uninstall the sipgate App via Snap Store/Application 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 the sipgate App normally\
or start without sandbox via terminal: ./sipgate-desktop --no-sandbox
**Fedora 39>40 update**:\
Start via double-click: hangs with an empty login window\
Start via terminal: Could not load window main: / Error: ERR\_FAILED\
**Cause**: Nouveau driver\
**Solution**: delete, re-sign/install 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 Debian 10:** there is no folder **chrome-sandbox**\
**Solution Debian 10:** unclear\
**Workaround Debian 10:**
\- Update to Debian 11.5, start the 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 just 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. But 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): trigger 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 will then start 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.