> 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/sipgate-app-fehler-und-loesungen.md).

# sipgate app: errors and solutions

Common sipgate app errors and their solutions - fix call setup, microphone, and connection issues.

#### General errors

<details>

<summary><strong>Error: Calls cannot be established. The selected microphone cannot be used. Please check your settings.</strong></summary>

**Solution**: Check the app's permissions to access the microphone

On **Windows 11** open START ➔ WINDOWS SETTINGS ➔ PRIVACY & SECURITY ➔ MICROPHONE. Enable the following options:

* Microphone access
* Allow apps to access your microphone
* Allow desktop apps to access your microphone

On **Apple macOS** open SYSTEM SETTINGS ➔ PRIVACY & SECURITY ➔ MICROPHONE. Enable access for the sipgate app there.

</details>

<details>

<summary><strong>Error: The audio connection could not be established.</strong></summary>

**Cause:** A firewall is preventing its use.\
**Solution:** Allow the [**IP and port ranges**](https://help.sipgate.de/cloud-telefonanlage/erste-schritte/alles-fur-den-start-mit-sipgate/nutzung-von-sipgate-mit-einer-firewall) for sipgate in the firewall

</details>

<details>

<summary><strong>Error: The login window opens briefly and then closes immediately — "An error occurred. Please try again."</strong></summary>

\
Cause: [login.sipgate.com](http://login.sipgate.com) is blocked by a hardware/software firewall, Pi-hole, or HTTP proxy\
Solution: [login.sipgate.com](http://login.sipgate.com) allow it\
Example: Fritz!Box ➔ Internet ➔ Filters ➔ Blocked websites: Edit ➔ [login.sipgate.com](http://login.sipgate.com) remove it\
Example: HTTP proxy: contact your network administrator\
Example: Windows Defender Firewall ➔ Advanced settings ➔ Outbound rules: sipgate.exe is blocked for outbound connections ➔ allow it

</details>

<details>

<summary><strong>Error: The update progress exceeds >100% and the update is not installed</strong></summary>

**Cause**: unknown\
**Solution**: unknown\
**Workaround**: Uninstall the sipgate app, download [the new version](https://www.sipgate.de/app-download) and install it

</details>

<details>

<summary><strong>Error: "installer integrity check has failed. Common causes include incomplete download and damaged media."</strong></summary>

**Cause**: The update download was interrupted or is incomplete.\
**Solution**: Quit the sipgate app, restart it, and let the update finish completely.

![NSIS.png](https://4045603198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg0qj71PeONPljdPedXLf%2Fuploads%2Fgit-blob-581acfe2169325d71433f2c9a577fe51fd774df1%2FNSIS.png?alt=media\&token=ad6b0d1e-acb5-4503-9a3b-d00b0daafd5e)

</details>

<details>

<summary><strong>Error: Outgoing calls fail with the error message: "An error occurred. Please try again."</strong></summary>

**Cause:** [login.sipgate.com](http://login.sipgate.com) is blocked by a firewall, Pi-hole, or HTTP proxy\
**Solution:** [login.sipgate.com](http://login.sipgate.com) allow it\
Example: Fritz!Box ➔ Internet ➔ Filters ➔ Blocked websites: Edit ➔ [login.sipgate.com](http://login.sipgate.com) remove it\
Example: HTTP proxy: contact your network administrator

</details>

<details>

<summary><strong>Error: You are already signed in to this session as another user. Please sign out first.</strong></summary>

**Cause:** Signing out of the workspace (e.g. in Close) does not automatically remove the login details stored in the sipgate.com cookie. Since these login details are stored as a third-party cookie, they remain active even after signing out.\
**Solution:** A fundamental redesign would be necessary to stop storing login details as a third-party cookie. This redesign would be technically complex.\
**Workaround**\
**Google Chrome:**\
Delete the cookie for sipgate.com or open the following link directly to remove it specifically: <chrome://settings/content/all?searchSubpage=sipgate.com>\
**Mozilla Firefox:** Go to: **Settings** → **Privacy & Security** → **Cookies and Site Data** → **Manage Data** Search for sipgate.com and click **Remove**, to delete the cookie.

</details>

<details>

<summary><strong>Error: "Cannot be used. Please check your audio settings"</strong></summary>

Behavior: Outgoing calls cannot be started or incoming calls cannot be answered\
Renderer log analysis: NotReadableError: Could not start audio source\
Cause: The operating system or another application is temporarily blocking access to your microphone/headset<br>

* The application may be a browser or a video/voice app

Solution:<br>

* Close other audio/video applications or browsers running in parallel, then start a new call
* Quit and restart the sipgate app. Access to the audio device will be requested again; test with a new call

</details>

<details>

<summary><strong>Error: Call disconnects after 7–11 seconds</strong></summary>

Cause 1: Outbound UDP is blocked by the software/hardware firewall\
Problem 1: IPv4+IPv6 connection, SIP over IPv6, but UDP over IPv4 = no audio\
Cause 2: unclear\
Analysis 1–2:

* Open the sipgate app.
* Click your avatar ➔ Report a problem ➔ Attach logs

\
Solution 1: Allow UDP traffic for the sipgate app\
Solution 2: Temporarily disable IPv6 on the PC/laptop until we have a solution

</details>

<details>

<summary><strong>Error: "There is a problem with your account. Please contact our support team."</strong></summary>

Analysis: [Workspace.sipgate.com](http://workspace.sipgate.com) Sign-in works, but signing in to the sipgate app does not\
Solution: Clear the cache\
Windows: Quit the app, delete the cache folder: %USERPROFILE%\AppData\Roaming\sipgate-desktop\Cache, start the app, sign in\
macOS: Quit the app, delete the cache folder: /Users/$USER/Library/Application Support/sipgate-desktop/Cache, start the app, sign in

</details>

#### Windows

<details>

<summary><strong>Error: Sign-in works, then the message "Oops! Something went wrong. Reload the app or try again later" appears</strong></summary>

**Analysis:**

* Open the sipgate app.
* Click your avatar ➔ Report a problem ➔ Attach logs

\
\[error] \[ws] ⛔️ Socket disconnected io client disconnect\
Error: Cannot read properties of undefined (reading 'some')\
**Workaround**: Open the sipgate app ➔ Help ➔ Clear cache and restart the app

</details>

<details>

<summary><strong>Error: "Update could not be installed. Check your internet connection and try again."</strong></summary>

**Cause**: The sipgate app was started without an internet connection\
**Solution**: Click **Open sipgate app** and enable the internet connection via Wi-Fi/LAN. Then install the update again.

</details>

<details>

<summary><strong>Error: No notifications are displayed (Windows)</strong></summary>

**Solution**: Enable Windows notifications:\
Win11: System ➔ Notifications ➔ ON\
\- sipgate app: ON\
\- sipgate app ➔ Notifications: ON\
\- sipgate app ➔ Show notification banners: enable

</details>

<details>

<summary><strong>Error: "An error occurred. The switch cannot be started. Please turn off active ad blockers or change the pop-up settings in your browser."</strong></summary>

**Problem**: Open the sipgate app; "Sign in" redirects to sipgate.de, but the browser blocks the redirect, resulting in the error message above\
**Cause**: A pop-up blocker is enabled in the browser\
**Solution**: Disable the pop-up blocker in the browser, restart the browser, and sign in to the sipgate app again\
\- You can re-enable the pop-up blocker in your default browser afterward

</details>

<details>

<summary><strong>Error: A white page is displayed for 1 minute before the login page opens; after logging in, a spinner is shown for 5 minutes before you are signed in</strong></summary>

**Problem**: Contacts are not loaded; only phone numbers are displayed, and\
Favorites could not be found in your CRM contacts.\
Cause: The folder is write-protected: C:\Users\Benutzername\AppData\Roaming\sipgate-desktop\IndexedDB\
**Solution:** Remove contacts from Favorites. Allow write access to the folder

</details>

<details>

<summary><strong>Error: " [info] [contacts] Destroying IndexedDB for contacts…" in renderer.log</strong></summary>

**Cause**: There is a problem with the database\
**Solution**:

Uninstall the sipgate app\
Manually delete the folder \*C:/Users/Username/AppData/Local/Programs/sipgate-desktop\*\
Manually delete the folder \*C:/Users/Username/AppData/Roaming/Programs/sipgate-desktop\*\
Install the sipgate app

</details>

<details>

<summary><strong>Error: The sipgate app cannot be installed and/or updated — "The sipgate app cannot be closed." / "A javascript error occured in the main process"</strong></summary>

**Cause**: PowerShell is running in "Constrained Language mode"; running PowerShell scripts is largely blocked\
**Solution**: Temporarily allow PowerShell to run in FullLanguage mode via Group Policy, install/update the sipgate app, then re-enable the Group Policy\
**Example**.: [Constrained Language Mode SRP/GPO](https://4sysops.com/archives/mitigating-powershell-risks-with-constrained-language-mode/)

</details>

<details>

<summary><strong>Error: The sipgate app cannot be selected as the default app for the TEL link type</strong></summary>

Cause: Certain Windows updates can overwrite the registry\
Solution:<br>

* Quit the sipgate app
* Open this path in File Explorer: %USERPROFILE%\AppData\Roaming\sipgate-desktop\FirstRun
* Delete both Tel files
* Restart the sipgate app. You should now be able to select it again for the TEL link type

</details>

#### Linux

<details>

<summary><strong>Error: The call list briefly appears without phone numbers, followed by an error message</strong></summary>

Problem: IndexedDB cannot load contacts from the app configuration\
Analysis:

* Open the sipgate app.
* Click your avatar ➔ Report a problem ➔ Attach logs

\
\[2023-08-23 11:03:29.521] \[error] \[contacts] Could not get contacts by id from IndexedDB\
**Cause**: IndexedDB cannot be accessed\
**Solution:** Open a Linux terminal and run **rm -rf .config/sipgate-desktop/**

</details>

<details>

<summary><strong>Error: The sipgate app window is gray; images and buttons do not load</strong></summary>

**Workaround**: Close the sipgate app, open a terminal, and run the following commands: find \~/.config/sipgate/ -name "GPUCache" | xargs rm -rf or find \~/.config/sipgate-desktop/ -name "GPUCache" | xargs rm -rf. Open the sipgate app; menus and graphics should now load correctly again

</details>

#### Mac

<details>

<summary><strong>Error: When selecting sipgate SSO, the email address is already signed in and you cannot sign in with another user</strong></summary>

**Cause**: /Users/$USER/LibrarError: When selecting sipgate SSO, the email address is already signed in and you can only enter the password. This means you cannot sign out of the sipgate app and sign in with another sipgate user. The email address is stored in Application Support/sipgate-desktop\
**Solution**:\
\- Uninstall the sipgate app\
\- Open Finder, select "Go to" and delete /Users/$USER/Library/Application Support/sipgate-desktop\
// Replace $User with your Mac username. Example: /Users/Mustermann/Library\
\- Then uninstall the sipgate app, delete the desktop folder, and sign in with sipgate SSO

</details>

<details>

<summary><strong>Error: Updates cannot be installed. Please check your internet connection</strong></summary>

**Cause**: The sipgate app was not moved to the Applications folder\
**Solution**: See "Installation" above. Uninstall and run the sipgate app, then use the Finder menu to move it to "Applications"

</details>

#### sipgate app in the web

<details>

<summary><strong>Error: The other person cannot hear me</strong></summary>

**Cause:** Microphone access is not granted\
**Solution:** [Grant microphone access](https://help.sipgate.de/hc/de/articles/27555234781085-Wie-erlaube-ich-den-Mikrofonzugriff-f%C3%BCr-die-sipgate-App-im-Browser)

</details>

<details>

<summary><strong>Error: No notifications are displayed (web)</strong></summary>

**Cause:** Notification access is not granted\
**Solution:** [Allow notifications for the sipgate app on the web](https://help.sipgate.de/hc/de/articles/27571594049181-Wie-kann-ich-Benachrichtigungen-f%C3%BCr-die-sipgate-App-im-Web-erlauben)

</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/sipgate-app-fehler-und-loesungen.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.
