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, a few prerequisites must be met.

Requirement

x86 CPU or 64-bit support (emulator) + allow PowerShell, ARM64 CPU

support

Windows 10 / 11 (64-bit)

Download the download file for the sipgate app from our website. Once the download is complete, copy the file "sipgate.exe" to your computer. Then the installation can be started. It is important to note that installations from a network drive can lead to an error message, so it is recommended to run the file locally on the PC.

There is currently no way to mass-install the sipgate app via an .msi file. However, there is the option to create your own .msi file. Various free and pro software solutions are available for this purpose:

Installation path

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

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

Installation on a terminal server

It is possible to install the sipgate app on a terminal server, but this is not intended as the standard configuration. Please note that connecting audio devices between the desktop and the terminal server is not supported.

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 then "Choose defaults by link type". Then select "[Tel: sipgate](Tel: sipgate "‌")" as the default.

WinTEL.png

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 problem as follows:

1. Quit the sipgate app. 2. Delete the "FirstRun" folder at "C:\Users\username\AppData\Roaming\sipgate-desktop\FirstRun". 3. Restart the sipgate app. 4. Now sipgate should be selectable as link type "Tel" and can be set as the default app for TEL.

Alternative: create TEL manually (Win10/11) - Open Registry Editor: Computer\HKEY_CLASSES_ROOT - Create folder: sipgate.tel Create subfolder: DefaultIcon (Computer\HKEY_CLASSES_ROOT\sipgate CLINQ.tel\DefaultIcon)

Create file: New String Value: C:\Users\username\AppData\Local\Programs\sipgate-desktop\sipgate CLINQ.exe &#xNAN;Replace "username" with your own username

Create subfolder: shell (Computer\HKEY_CLASSES_ROOT\sipgate CLINQ.tel\shell)

New Create string Value: is empty

Create sub-subfolder under shell: open (Computer\HKEY_CLASSES_ROOT\sipgate CLINQ.tel\shell\open)

New Create strings, value: is empty

Sub-sub-subfolder: command (Computer\HKEY_CLASSES_ROOT\sipgate CLINQ.tel\shell\open\command)

New Create string, value: "C:\Users\username\AppData\Local\Programs\sipgate-desktop\sipgate CLINQ.exe" "%1" &#xNAN;Replace "username" with your own username

Enable notifications for the sipgate app

To make sure you receive notifications from the sipgate app in Windows version 11, follow this path: Settings ➔ System ➔ Notifications ➔ ON. After you have enabled the general notification function, you can make specific settings in the sipgate app: Open the sipgate app ➔ Settings ➔ Notifications ➔ ON. To make sure you also receive notifications visually, enable the following setting: sipgate app settings ➔ Show notification banners.

How can I set the region/country correctly 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 Germany set and team UK users have England set. If another country is set, this can lead to problems with displaying phone numbers, availability, and saving contacts.

sipgate.de= Germany sipgate.co.uk = UK Windows 10/11: Control Panel -> Region: set Format to DE or UK

Network installation of the sipgate app

We recommend using the app on the web:

sipgate app Users always have the current version and user rights are sufficient.

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

To avoid manual updates by users, it is recommended to use a software management tool:

Errors & solutions

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

- Check Windows group policies from admins that might be blocking the installation. - Temporarily disable local software firewall/anti-virus programs. - On Surface Pro X SQ1/SQ2, test a 64-bit emulator. - If an error message appears after logging in, "Reset cache" in the sipgate app help options may help. If none of these steps helped, send your sipgate logs with the error description to support.

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

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

Solution: 1. Temporarily adjust the group policy to allow the use of PowerShell in FullLanguage mode. 2. Perform the sipgate app installation/update. 3. Re-enable the group policy to restore the original state. 4. Example: Constrained Language mode in SRP/GPO use.

These steps should allow the app installation or update to be completed successfully, and the error messages should no longer appear. However, note that the group policy should only be temporarily adjusted so as not to permanently affect the security settings.

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

Error message: "sipgate app cannot be closed." or "sipgate App cannot be closed." Cause: sipgate app is still active Solution: open the system tray at the bottom right, right-click the sipgate icon "Quit sipgate app" or open Task Manager and quit sipgate app or restart the PC, provided the sipgate app is not active in autostart

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

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

Solution:

  1. Temporarily adjust the group policy to allow the use of PowerShell in FullLanguage mode.

  2. Perform the sipgate app installation/update.

  3. Re-enable the group policy to restore the original state.

  4. Example:

Constrained Language mode in SRP/GPO use.

These steps should allow the app installation or update to be completed successfully, and the error messages should no longer appear. However, note that the group policy should only be temporarily adjusted so as not to permanently affect the security settings.

Error: No microphone can be selected in the app

If no microphone can be selected 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

Alternative: In software firewall such as Norton/Kaspersky, check and allow microphone access

Uninstalling the sipgate app

How can the sipgate app be completely uninstalled?

Windows Apps and Features search for sipgate app tap "Uninstall" click

Screenshot from 2024-08-20 08-38-02.png

Open the desktop in Windows and select This PC .

Screenshot from 2024-08-20 08-21-50.png

Select the C: drive and navigate to Users and click your username.\

Screenshot from 2024-08-20 08-24-11.png

Click the folder AppData. If this is not visible, enable it via the options or follow a Google guide.

Via the folders Local and Roaming you will 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

Last updated