> 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-windows.md).

# How do I install the sipgate app on Windows?

Requirements and instructions for installing the sipgate app on Windows desktops.

To install the sipgate app on a Windows desktop, some requirements must be met.

| **Prerequisite** | x86 CPU or 64-bit support (emulator) + PowerShell enabled, ARM64 CPU |
| ---------------- | -------------------------------------------------------------------- |
| **support**      | Windows 10 / 11 (64-bit)                                             |

Download the [download file](https://www.sipgate.de/app-download) for the sipgate app from our website. Once the download is complete, copy the file "sipgate.exe" to your computer. You can then start the installation. Please note that installing from a network drive may result in an error message, so we recommend running the file locally on your PC.

There is currently no way to install the sipgate app in bulk using an .msi file. However, you can create your own .msi file. Various free and paid software solutions are available for this purpose:

* InstallShield
* Advanced Installer
* MSI Factory
* [WiX Toolset](https://wixtoolset.org/)
* [Advanced Installer](https://www.advancedinstaller.com/)
* [NSIS (Nullsoft Scriptable Install System)](https://nsis.sourceforge.io/Main_Page)
* Microsoft Visual Studio Installer Projects
* [Various installer software](https://rbytes.net/software/development_c/install-and-setup_s/)

#### Installation path

During installation, the sipgate app is installed in the following directories by default:

* %USERPROFILE%\AppData\Local\Programs\sipgate-desktop\
  %USERPROFILE%\AppData\Roaming\sipgate-desktop

#### Installation on a terminal server

You can install the sipgate app on a terminal server, but this is not a standard configuration. Please note that connecting audio devices between the desktop and the terminal server is not supported.

#### Set up the sipgate app for microphone access

In Windows ➔ Privacy & security ➔ Microphone:\
Microphone access: ON\
Let apps access your microphone: ON\
Let desktop apps access your microphone: ON

#### Set the sipgate app as the default app for TEL

If you are using Windows 11, you can set the sipgate app as the default app for the telephone function (TEL) by going to "Default apps" and selecting "Choose defaults by link type". Then select "\[Tel: sipgate]\(Tel: sipgate "‌")" as the default.

![WinTEL.png](https://4045603198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg0qj71PeONPljdPedXLf%2Fuploads%2Fgit-blob-dfe6011e5c1165843aac52602a5f96075d396ae2%2FWinTEL.png?alt=media\&token=46082d45-106b-4708-b204-092056d58efd)

If you have Windows 10/11 22H2 and the option to select the sipgate app as the default app for TEL is not displayed, you can fix the issue as follows:

1\. Close the sipgate app.\
2\. Delete the "FirstRun" folder at "C:\Users\Benutzername\AppData\Roaming\sipgate-desktop\FirstRun".\
3\. Restart the sipgate app.\
4\. You should now be able to select sipgate as the link type "Tel" and set it as the default app for TEL.

**Manually add TEL (Win10/11)**

* download the desired TXT file:<br>

{% file src="/files/e22514ac1aad19e151d2bcfba9ab75ef255be2d7" %}

{% file src="/files/e65c3b17573584abc576f28aed0ae122c79eb047" %}

{% file src="/files/879d955d34e3aabd60eeb4784b76917f8ba9800d" %}

* in the TXT file, replace "Benutzername" with your own computer username
* save the file as .reg instead of .txt
* run the file and confirm the Windows prompt by clicking Yes
* in Windows **➔** Apps **➔** Default apps **➔** Choose defaults by link type; select the sipgate app for the link type
* Clicking phone numbers in your CRM with callto: / sip: / tel: should now open the sipgate app

#### Enable notifications for the sipgate app

To make sure you receive notifications from the sipgate app on Windows 11, follow this path: **Settings ➔ System ➔ Notifications ➔ ON**.\
After enabling general notifications, you can configure specific settings in the sipgate app: Open the sipgate app **➔ Settings ➔ Notifications ➔ ON**.\
To make sure you also receive visual notifications, enable the following setting: **sipgate app settings** **➔ Show notification banners.**

#### How do I set the correct region/country in the operating system for the sipgate product?

The sipgate app reads the region/country from the operating system, assuming that team DE users have set Germany and team UK users have set England. If a different country is set, this can cause problems with how phone numbers are displayed, reachability, and saving contacts.

[**sipgate.de**](http://sipgate.de/)= Germany\
[**sipgate.co.uk**](http://sipgate.co.uk/) = UK\
**Windows 10/11:** Control Panel -> Region: Set the format to DE or UK

#### Network installation of the sipgate app

We recommend using the app on the web:

[sipgate app](http://workspace.sipgate.com/)\
Users always have the latest version, and their user permissions are sufficient.

**Note**:\
There is currently no .msi for network installation.\
Local administrator rights are required to install or update the sipgate app on Windows.

To avoid manual updates by users, we recommend using a software management tool (MDM):<br>

* current .[yml file](https://desktop.download.sipgate.com/latest.yml) to check for new versions
* baramundi: Use the [software distribution](https://www.baramundi.com/de-de/it-loesungen/softwareverteilung/).
* Microsoft Intune
  * Installation in user context (sipgate.exe /S)
  * SAML SSO with Microsoft Entra ID is configured and active in the sipgate account
  * Windows 11 PCs, joined to Entra ID and managed through Intune

**Errors & Solutions**

If the sipgate app installation on your Windows computer does not work as expected, you can try the following steps as possible solutions:\\

\- Check Windows Group Policies set by admins that might be blocking the installation.\
\- Temporarily disable local software firewalls/antivirus programs.\
\- On Surface Pro X SQ1/SQ2, try a 64-bit emulator.\
\- If an error message appears after logging in, "Reset cache" in the sipgate app's help options may help.\
If none of these steps help, send your sipgate logs and a description of the error to Support.

<details>

<summary><strong>Error: sipgate app installation/update does not work — "sipgate cannot be closed." and "A javascript error occurred in the main process"</strong></summary>

**Cause:** PowerShell is running in "Constrained Language mode", which blocks the execution of PowerShell scripts.

**Solution:**\
1\. Temporarily modify the Group Policy to allow PowerShell to be used in FullLanguage mode.\
2\. Install/update the sipgate app.\
3\. Re-enable the Group Policy to restore the original state.\
4\. Example: [Constrained Language Mode in SRP/GPO](https://4sysops.com/archives/mitigating-powershell-risks-with-constrained-language-mode/) use.

These steps should allow the app to be installed or updated successfully, and the error messages should no longer appear. However, the Group Policy should only be modified temporarily to avoid permanently compromising security settings.

</details>

<details>

<summary><strong>Error: sipgate app installation/update does not work — "sipgate app cannot be closed."</strong></summary>

**Error message**: "sipgate app cannot be closed." or "sipgate App cannot be closed."\
**Cause**: sipgate app is still running\
**Solution:** Open the system tray at the bottom right and right-click the sipgate icon **➔** "Quit sipgate app"\
or open Task Manager and end the sipgate app task\
or restart the PC, provided the sipgate app is not enabled at startup

</details>

<details>

<summary><strong>Error: sipgate app installation/update does not work — "A javascript error occurred in the main process"</strong></summary>

**Cause:** PowerShell is running in "Constrained Language mode", which blocks the execution of PowerShell scripts.

**Solution:**

1. Temporarily modify the Group Policy to allow PowerShell to be used in FullLanguage mode.
2. Install/update the sipgate app.
3. Re-enable the Group Policy to restore the original state.
4. Example:

[Constrained Language Mode in SRP/GPO](https://4sysops.com/archives/mitigating-powershell-risks-with-constrained-language-mode/) use.

These steps should allow the app to be installed or updated successfully, and the error messages should no longer appear. However, the Group Policy should only be modified temporarily to avoid permanently compromising security settings.

</details>

<details>

<summary><strong>Error: No microphone can be selected in the app</strong></summary>

If you cannot select a microphone in the sipgate app, you can allow access as follows:

In Windows **➔** Settings **➔** Privacy & security **➔** Microphone

* Microphone access: ON
* Allow apps to access your microphone: ON

Exception: Check and allow microphone access in software firewalls such as Norton/Kaspersky

</details>

#### Uninstalling the sipgate app

**How can I completely uninstall the sipgate app?**

In Windows, search for the sipgate app under Apps & features, tap it, then click “Uninstall”

![Screenshot from 2024-08-20 08-38-02.png](https://4045603198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg0qj71PeONPljdPedXLf%2Fuploads%2Fgit-blob-32e5a7a3689ced2eb790808dd778e403d7b637ec%2FBildschirmfoto%20vom%202024-08-20%2008-38-02.png?alt=media\&token=70f54e9d-81fc-44ec-bbbb-1214dbb6b189)

Open the desktop in Windows and select **This PC** .

![Screenshot from 2024-08-20 08-21-50.png](https://4045603198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg0qj71PeONPljdPedXLf%2Fuploads%2Fgit-blob-702a6062ddb3486ae8d2b78bf08a4faa29060a16%2FBildschirmfoto%20vom%202024-08-20%2008-21-50.png?alt=media\&token=0eb27d27-2f1c-44f5-870d-b651aca88202)

Select **Local Disk (C:)** , navigate to **Users** and click your **username**.\\

![Screenshot from 2024-08-20 08-24-11.png](https://4045603198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg0qj71PeONPljdPedXLf%2Fuploads%2Fgit-blob-2155cb2b6c1ed51fc38430933cf0fecd4055ea06%2FBildschirmfoto%20vom%202024-08-20%2008-24-11.png?alt=media\&token=282ac51b-8aa7-4ed4-92c6-f822a24d998c)

Click the **AppData**. If it isn’t visible, enable it in **Options** or follow a **Google guide**.\
![](https://4045603198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg0qj71PeONPljdPedXLf%2Fuploads%2Fgit-blob-1ace70cf2913104d1d83d2ff64e786e15e232563%2Fmceclip3.png?alt=media\&token=cbffa650-08c3-4a5c-968d-ee3b08c0409d)

In the **Local** and **Roaming** folders, you’ll find the **sipgate-desktop folder**, which you can delete:\
%USERPROFILE%\AppData\Local\Programs\sipgate-desktop\
%USERPROFILE%\AppData\Roaming\sipgate-desktop\
![Bildschirmfoto vom 2024-08-20 08-25-27.png](https://4045603198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fg0qj71PeONPljdPedXLf%2Fuploads%2Fgit-blob-90053174f11b5e6fb6afb071afa81bfae8201b60%2FBildschirmfoto%20vom%202024-08-20%2008-25-27.png?alt=media\&token=30c6dad9-9d0c-4feb-bb38-7d3db56e135c)

{% hint style="warning" %}
**Important:** Unfortunately, settings, login credentials, and contacts remain after uninstalling. This data must be deleted manually.
{% endhint %}


---

# 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-windows.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.
