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

# sipgate App: Fehler und Lösungen

#### Allgemeine Fehler

<details>

<summary><strong>Fehler: Gespräche können nicht aufgebaut werden. Das ausgewählte Mikrofon kann nicht verwendet werden. Bitte überprüfe deine Einstellungen.</strong></summary>

**Lösung**: Prüfen Sie die Zugangsberechtigungen auf das Mikrofon für die App

Unter **Windows 11** öffnen Sie über START ➔ WINDOWS EINSTELLUNGEN ➔ DATENSCHUTZ UND SICHERHEIT ➔ MIKROFON. Dort folgende Optionen aktivieren:

* Mikrofonzugriff
* Apps den Zugriff auf Ihr Mikrofon erlauben
* Zulassen, dass Desktop-Apps auf Ihr Mikrofon zugreifen

Unter **Apple macOS** öffnen Sie die SYSTEMEINSTELLUNGEN ➔ DATENSCHUTZ & SICHERHEIT ➔ MIKROFON. Aktivieren Sie dort den Zugriff für die sipgate App.

</details>

<details>

<summary><strong>Fehler: Die Audioverbindung konnte nicht aufgebaut werden.</strong></summary>

**Ursache:** Firewall verhindert die Nutzung.\
**Lösung:** In der Firewall die [**IP- und Portbereiche**](https://help.sipgate.de/hc/de/articles/4983838712477-Was-sind-die-IP-und-Port-Bereiche-von-sipgate) für sipgate freigeben

</details>

<details>

<summary><strong>Fehler: Das Loginfenster öffnet sich kurz und schließt sofort — "Es ist ein Fehler aufgetreten. Bitte probier es noch einmal."</strong></summary>

**Analyse**: sipgate App ➔ Hilfe ➔ Logs exportieren ➔ Zip speichern\
im renderer.log nach \[Datum Uhrzeit] \[error] \[app] other suchen\
**Ursache**: [login.sipgate.com](https://login.sipgate.com/) wird in Firewall/pi hole geblockt\
**Lösung**: [login.sipgate.com](https://login.sipgate.com/) erlauben\
**Bsp**.: Fritz!Box ➔ Internet ➔ Filter ➔ Gesperrte Internetseiten: bearbeiten ➔ [login.sipgate.com](http://login.sipgate.com) steht im Filter, sollte man raus nehmen

</details>

<details>

<summary><strong>Fehler: Updateverlauf geht über >100% und installiert Update nicht</strong></summary>

**Ursache**: unklar\
**Lösung**: unklar\
**Workaround**: sipgate App deinstallieren, neue Version [laden](https://www.sipgate.de/app-download) und installieren

</details>

<details>

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

**Ursache**: Der Download für das Update wurde unterbrochen oder ist unvollständig.\
**Lösung**: sipgate App beenden, neustarten und Update vollständig abschließen.

![NSIS.png](/files/lm5EobZcuFXpZgKYDYQ0)

</details>

<details>

<summary><strong>Fehler: Raus rufen bricht mit Fehlermeldung ab: "Es ist ein Fehler aufgetreten. Bitte probier es noch einmal."</strong></summary>

**Analyse**: sipgate App ➔ Hilfe ➔ Logs exportieren: renderer.log\
\[error] \[call] Could not dial call Error: Request failed with status code 500\
**Ursache**: "sipgate App" Telefon im sipgate Asterisk startet keinen Anruf zum [sipgate.de](http://sipgate.de) Asterisk\
**Hinweis**: sipgate Telefone wie sipgate Webphone / VoIP Telefon Bsp.: SNOM sind nicht betroffen und können verwendet werden\
**Workaround**: [sipgate.de](http://sipgate.de) einloggen, ein zweites Telefon anlegen\
\- in sipgate App ➔ Anrufliste ➔ Zahnrad Einstellungen Telefon 2 für ausgehende Anrufe einstellen\
\- ausgehende Anrufe mit den neuen SIP-Daten sollte nun klappen.

**Lösung**: Der Fehler sollte grundsätzlich behoben sein. Falls er weiterhin auftritt, bitte an die sipgate Kundenbetreuung wenden.

</details>

<details>

<summary><strong>Fehler: Sie sind in dieser Session bereits mit einem anderen Benutzer angemeldet. Bitte melden Sie sich zuerst ab.</strong></summary>

**Ursache:** Ein Logout im Workspace (z. B. in Close) entfernt nicht automatisch die Login-Daten, die im sipgate.com-Cookie gespeichert sind. Da diese Login-Daten als Third-Party-Cookie gespeichert werden, bleiben sie auch nach dem Ausloggen aktiv.\
**Lösung:** Ein grundlegender Umbau wäre notwendig, damit die Login-Daten nicht mehr als Third-Party-Cookie gespeichert werden. Dieser Umbau ist technisch aufwendig.\
**Workaround**\
**Google Chrome:**\
Löschen Sie das Cookie für sipgate.com oder öffnen Sie direkt folgenden Link, um es gezielt zu entfernen: <chrome://settings/content/all?searchSubpage=sipgate.com>\
**Mozilla Firefox:** Gehen Sie zu: **Einstellungen** → **Datenschutz & Sicherheit** → **Cookies und Website-Daten** → **Daten verwalten** Suchen Sie nach sipgate.com und klicken Sie auf **Entfernen**, um das Cookie zu löschen.

</details>

<details>

<summary><strong>Fehler: "Kann nicht verwendet werden. Bitte überprüfe deine Audio-Einstellungen"</strong></summary>

Verhalten: ausgehender Anruf kann nicht gestartet werden oder eingehend Anruf nicht angenommen werden\
Analyse renderer Logs: NotReadableError: Could not start audio source\
Ursache: Das Betriebssystem / eine andere Anwendung blockiert temporär den Zugriff auf Ihr Mikrofon/Headset<br>

* Anwendung kann Browser oder Video/Sprach App sein

Lösung:<br>

* andere parallel offene Audio/Video Anwendung/Browser beenden und dann neuen Anruf starten
* sipgate App beenden, neustarten, Mediazugriff auf Audiogerät wird neu angefragt, neuen Anruf testen

</details>

<details>

<summary><strong>Fehler: Anruf bricht nach 7-11 Sekunden ab</strong></summary>

Ursache 1: UDP ausgehend ist in der Software/Hardware-Firewall blockiert\
Problem 1: IPv4+IPv6 Anschluss, SIP via IPv6, UDP aber via IPv4 = kein Audio\
Ursache 2: unklar\
Analyse 1-2: sipgate App ➔ Hilfe ➔ Logs exportieren ➔ renderer.log ➔ \[info] \[call] Inbound Audio Level Report: 'Empty Audio': '10.111s (100%)'\
Lösung 1: für die sipgate App UDP Übertragung erlauben\
Lösung 2: IPv6 temporär auf dem PC/Laptop deaktivieren bis wir eine Lösung haben

</details>

<details>

<summary><strong>Fehler "Es besteht ein Problem mit deinem Account. Bitte wende dich an unseren Support."</strong></summary>

Analyse: [Workspace.sipgate.com](http://workspace.sipgate.com) einloggen klappt, nur sipgate App einloggen klappt nicht\
Lösung: Cache zurücksetzen\
Windows: App beenden, Cache Ordner löschen: %USERPROFILE%\AppData\Roaming\sipgate-desktop\Cache, App starten, einloggen\
MacOS: App beenden, Cache Ordner löschen: /Users/$USER/Library/Application Support/sipgate-desktop/Cache, App starten, einloggen

</details>

#### Windows

<details>

<summary><strong>Fehler: Einloggen klappt, dann erscheint "Uups! Etwas ist schief gelaufen. Lade die App neu oder versuche es später nochmal"</strong></summary>

**Analyse:** sipgate App ➔ Hilfe ➔ Logs exportieren ➔ renderer.log\
\[error] \[ws] ⛔️ Socket disconnected io client disconnect\
Error: Cannot read properties of undefined (reading 'some')\
**Workaround**: sipgate App öffnen ➔ Hilfe ➔ Cache zurücksetzen und App neu starten

</details>

<details>

<summary><strong>Fehler: "Update konnte nicht installiert werden. Überprüfe deine Internetverbindung und versuche es erneut."</strong></summary>

**Ursache**: sipgate App wurde ohne Internet gestartet\
**Lösung**: auf **sipgate App öffnen** klicken und Internet via Wifi/Lan aktivieren. Anschließend Update erneut installieren.

</details>

<details>

<summary><strong>Fehler: Es werden keine Benachrichtigungen angezeigt (Windows)</strong></summary>

**Lösung**: Windows Benachrichtigungen aktivieren:\
Win11: System ➔ Benachrichtigungen ➔ EIN\
\- sipgate App: EIN\
\- sipgate App ➔ Benachrichtigungen: EIN\
\- sipgate App ➔ Benachrichtigungsfenster anzeigen: aktivieren

</details>

<details>

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

**Problem**: sipgate App öffnen, "Anmelden" will weiterleiten zu sipgate.de, der Browser blockiert die Weiterleitung und es kommt zu obiger Fehlermeldung\
**Ursache**: im Browser ist ein Pop-up Blocker aktiv\
**Lösung**: im Browser Pop-up Blocker deaktivieren, Browser neustarten, sipgate App erneut einloggen\
\- im Standard Browser kann man anschließend wieder den Pop-up Blocker aktivieren

</details>

<details>

<summary><strong>Fehler: 1min weiße Seite bis sich der Login öffnet, nach dem Login sieht man 5min Spinner bis man eingeloggt wird</strong></summary>

**Problem**: Kontakte werden nicht geladen man sieht nur Rufnummern und\
Favoriten konnten nicht in deinen CRM-Kontakten gefunden werden.\
Ursache: Ordner ist schreibgeschützt C:\Users\Benutzername\AppData\Roaming\sipgate-desktop\IndexedDB\
**Lösung:** Kontakte aus Favoriten entfernen. Ordner Schreibrechte erlauben

</details>

<details>

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

**Ursache**: Es gibt ein Problem mit der Datenbank\
**Lösung**:

sipgate App deinstallieren\
Manuell den Ordner \*C:/Users/Benutzer/AppData/Local/Programs/sipgate-desktop\* löschen\
Manuell den Ordner \*C:/Users/Benutzer/AppData/Roaming/Programs/sipgate-desktop\* löschen\
sipgate App installieren

</details>

<details>

<summary><strong>Fehler: sipgate App Installation und/oder Update klappt nicht — "sipgate App kann nicht geschlossen werden." / "A javascript error occured in the main process"</strong></summary>

**Ursache**: PowerShell arbeitet im "Constrained Language mode", das Ausführen von PowerShell Scripte sind weitesgehend blockiert\
**Lösung**: Gruppenrichtlinie temporär die Nutzung von PowerShell im FullLanguage Modus erlauben, sipgate App Installation/Update ausführen, Gruppenrichtlinie wieder aktivieren\
**Bsp**.: [Constrained Language Modus SRP/GPO](https://4sysops.com/archives/mitigating-powershell-risks-with-constrained-language-mode/)

</details>

<details>

<summary><strong>Fehler: sipgate App nicht als Standard App für Linktyp: TEL auswählbar</strong></summary>

Ursache: bestimmte Windows Updates können Registry überschreiben\
Lösung:<br>

* sipgate App beenden
* im Datei Explorer den Pfad öffnen: %USERPROFILE%\AppData\Roaming\sipgate-desktop\FirstRun
* beide Tel Dateien löschen
* sipgate App neustarten, sipgate App sollte nun wieder bei Linktyp TEL auswählbar sein

</details>

#### Linux

<details>

<summary><strong>Fehler: man sieht kurz Anrufliste ohne Rufnummern, dann Fehlermeldung</strong></summary>

Problem: indexexDB kann Kontakte aus der App Konfig nicht laden\
Analyse: sipgate App ➔ Hilfe ➔ Logs exportieren ➔ Zip ➔ renderer.log\
\[2023-08-23 11:03:29.521] \[error] \[contacts] Could not get contacts by id from IndexedDB\
**Ursache**: auf indexedDB kann nicht zugegriffen werden\
**Lösung:** Linux terminal öffnen und ausführen **rm -rf .config/sipgate-desktop/**

</details>

<details>

<summary><strong>Fehler: sipgate App Fenster ist grau, Bilder und Buttons werden nicht geladen</strong></summary>

**Workaround**: sipgate App schließen, Terminal öffnen und nachfolgende Befehle ausführen find \~/.config/sipgate/ -name "GPUCache" | xargs rm -rf oder find \~/.config/sipgate-desktop/ -name "GPUCache" | xargs rm -rf sipgate App öffnen, Menüs und Grafiken sollten nun wieder korrekt geladen werden

</details>

#### Mac

<details>

<summary><strong>Fehler: bei Auswahl sipgate SSO ist die E-Mail bereits eingeloggt und man kann sich nicht mit anderem Benutzer einloggen</strong></summary>

**Ursache**: /Users/$USER/LibrarFehler: bei Auswahl sipgate SSO ist die E-Mail bereits eingeloggt und man kann nur noch das Passwort eintragen, damit kann man sich nicht aus der sipgate App ausloggen und mit anderen sipgate Benutzer einloggen. Unter Application Support/sipgate-desktop ist die E-Mail Adresse fest hinterlegt\
**Lösung**:\
\- sipgate App deinstallieren\
\- Finder öffnen "Gehe zu" /Users/$USER/Library/Application Support/sipgate-desktop löschen\
// $User durch eigenen Mac Benutzernamen ersetzen: Bsp.: /Users/Mustermann/Library\
\- dann sipgate App deinstallieren und den Desktop-Ordner löschen und mit sipgate SSO einloggen

</details>

<details>

<summary><strong>Fehler: Updates können nicht installiert werden. Bitte überprüfe deine Internetverbindung</strong></summary>

**Ursache**: sipgate App wurde nicht in den Application Ordner verschoben\
**Lösung**: Siehe oben "Installation" sipgate App deinstallieren, ausführen, via Findermenü nach "Application" verschieben

</details>

#### sipgate App im Web

<details>

<summary><strong>Fehler: Der Gesprächspartner kann mich nicht hören</strong></summary>

**Ursache:** Freigabe für Mikrofon fehlt\
**Lösung:** [Freigabe für Mikrofon erteilen](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>Fehler: Es werden keine Benachrichtigungen angezeigt (Web)</strong></summary>

**Ursache:** Freigabe für Benachrichtigungen fehlt\
**Lösung:** [Benachrichtigungen für die sipgate App im Web erlauben](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 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/sipgate-nutzen/die-sipgate-app/sipgate-app-fehler-und-loesungen.md?ask=<question>&goal=<endgoal>
```

`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.
