Why does re-establishing a connection to the desktop app or the web client fail?

If re-establishing a connection to the desktop app or the web client fails, either push notifications aren't working properly or there is a problem in regard to Threema’s background activity. Please follow the troubleshooting instructions for Android or iOS.

Related articles

  • Download the latest version of the desktop app for Windows from the Download page (preferably using a browser other than Microsoft Edge; e.g., Firefox)
  • Open the downloaded file

To chat from the computer, you can either use the desktop app or the web client (“Threema Web”).

In both cases, you need the Threema mobile app (for Android or iOS), and your mobile device must be connected to the Internet.

  1. On your computer, either download and open the desktop app or open the web client (with a supported browser)
  2. In the mobile app, select “Desktop/Web,” and activate the scanner:
    • Android: Main menu > “Desktop/Web” > "Initiate new Session" / QR code symbol
    • iOS: “Settings” > “Desktop/Web” > camera icon in the top right corner
  3. Use your mobile device to scan the QR code displayed on the computer screen

Hint: To avoid having to scan the QR code each time you (re)start the desktop app / web client, set a session password in the browser before scanning.

Both the desktop app and the web client allow you to use Threema on a desktop computer. You need the mobile app (for Android or iOS) in both cases, and your mobile device must be connected to the Internet.

Learn how to use the desktop app and the web client →

The desktop app is available for macOS, Windows, and Linux. The web client can be used in most web browsers. In terms of features, there’s no difference between desktop app and web client. Since they are based on the same architecture, they also share the following characteristics:

  • Complete synchronization: By scanning a QR code, computer and mobile device are connected at once, and all conversations are fully accessible on the desktop.

  • Security and data restraint: All communication between phone and computer is fully end-to-end encrypted. After the session is terminated, all synchronized messages are immediately deleted on the desktop.

  • Open Source: Like the mobile apps, the desktop app and the web client are open source and use open standards. It’s also possible to host the web client on your own server.

In terms of security, the desktop app offers slight advantages. For one thing, there’s no way for browser plugins to introduce vulnerabilities. For another, it would be even more difficult for attackers to manipulate the app code since it isn’t loaded from a server each session but permanently stored on the user’s end.

For detailed technical information in regard to security, please refer to the Cryptography Whitepaper.

The desktop app is available for current 64 bit versions of macOS, Windows, and Linux.

The following browsers are supported:

Threema for Android Threema for iOS
Apple Safari 0 1
Chromium 1 1
Google Chrome 1 1
Microsoft Edge 1 1
Mozilla Firefox 1 1
Opera 1 1

macOS

  • Open System Preferences (e.g., via the Apple menu in the top left corner)
  • Select “Notifications,” find “Threema,” and click on it
  • Enable “Allow Notifications from Threema” (and define how you would like the notifications to appear)

Please note, that these settings can only be changed after you have received at least one message with the desktop app.

To learn more about notifications on macOS, please refer to this Apple article.

Windows

  • Navigate to Start > Settings > System > Notifications
  • In “Notifications from apps and other senders,” activate “Threema”

To learn more about notifications on Windows, please refer to this Microsoft article.

In order for the web client to display desktop notifications, the respective permission must be granted in the browser. If this permission was denied initially, it can be granted later as follows:

Chromium/Google Chrome

  1. Close the web client
  2. Insert “chrome://settings/content” in the URL bar, and press Enter
  3. Under “Notifications”, click “Manage exceptions”
  4. Change the Behavior of “https://web.threema.ch/” from “Block” to “Allow”
  5. Open Threema Web

Firefox

  1. Close the web client
  2. Insert “about:preferences#privacy” in the URL bar, and press Enter
  3. Under “Notifications”, click “Choose…”
  4. First, select “https://web.threema.ch/”; then, click “Remove Site“ and “Save Changes”
  5. Open Threema Web, and grant permission to send notifications

Opera

  1. Close the web client
  2. Insert “opera://settings” in the URL bar, and press Enter
  3. First, click on “Websites”; then, under “Notifications”, click “Manage exceptions…”
  4. Change the Behavior of “https://web.threema.ch/” from “Block” to “Allow”
  5. Open the web client

The desktop app and the web client currently provide the following features:

  • Full access to all contacts, media and chats, including past conversations
  • Send/receive text messages, pictures and media
  • Send/receive files (send files using drag and drop)
  • Send/receive emoji
  • Play animated GIFs
  • Agree/disagree feature
  • Add contacts
  • Manage groups and distribution lists
  • Set a session password

These are the main characteristics and advantages of Threema’s desktop app / web client:

  • It allows you to use Threema on the desktop without compromising security
  • It reduces the digital footprint to the bare minimum by establishing a direct connection between desktop and mobile device (Android)
  • No mirroring of the user’s message database – neither on a server nor on the desktop
  • The web-client is platform-independent
  • Open source
  • WebRTC, a tried and tested open standard for direct communication between two devices (Android)
  • SaltyRTC ensures a secure connection between browser and mobile device (Android)

Desktop app and web client work the same way. In both cases, an end-to-end encrypted connection is established between the computer and the mobile device. Synchronized messages are kept in volatile memory only. As soon as you end the session on your computer (e.g., by closing the desktop app / web client or by explicitly stopping or deleting the session), the messages are gone. The desktop app and the web client merely act as an extension of the mobile app and hence meet Threema’s high security standard.

The technical details are documented here.

The desktop app and the web client are currently available in English and German. If German is set as preferred language in the OS (desktop app) or in the browser (web client), German is used; English is used in all other cases.

If establishing a connection to the desktop app or the web client freezes at 60%, it’s not possible to connect computer and mobile device using WebRTC.

If you use the desktop app, please make sure you are using the latest version.

If you use the web client, make sure you use a supported browser, checkt that no browser plugin (such as an ad blocker) is disabling WebRTC, and reload the web client.

If you are behind a (corporate) firewall or are using a VPN, Deep Packet Inspection might block WebRTC.

To use the desktop app or the web client without having to scan the QR code each time, you can set a session password.

Enter a session password in the desktop app or the web client before scanning the displayed QR code with your mobile device. To use the desktop app or the web client the next time on the same computer, you can simply enter this password (instead of scanning the QR code again).

This way, it’s also possible to use Threema if your mobile device isn’t present (provided it’s connected to the Internet).

The different sessions are listed in the mobile app, where you can remove and rename them.

If sessions are not saved despite using a session password, browser settings might prevent the data necessary for restoring sessions from being stored locally.

Please adjust your browser settings as follows:

Chromium / Google Chrome

  1. Enter “chrome://settings/content/cookies” in the URL bar, and press Enter
  2. Add “web.threema.ch” to “ Sites that can always use cookies”
  3. Deactivate “Always clear cookies when windows are closed”
  4. Restart Chromium / Google Chrome

Mozilla Firefox

  1. Enter “about:preferences#privacy” in the URL bar, and press Enter
  2. If, in the “History” section, “Never remember history” is set, change this setting to “Use custom settings for history”
  3. Click the “Exceptions” button next to “Accept cookies from sites”
  4. As “Address of website”, enter “https://web.threema.ch/”, and click “Allow” and then “Save Changes”
  5. If (in the “History” section) “Clear history when Firefox closes” is activated, click the “Settings” button; if “Cookies” is checked, uncheck it and confirm by clicking “OK”
  6. Restart Firefox

The connection between the desktop app / the web client and the mobile device is usually stable. If you use an Android device and the connection is interrupted on a regular basis, please connect your computer and your mobile device to the same local network, if possible. Please check also if you are using the latest app version, and update the Threema, if necessary.

Huawei/Xiaomi

On Huawei and Xiaomi devices, the OS closes the connection between the web browser and the Threema app. To prevent this from happening, please perform the following steps:

  • Summon the Task Manager (by pressing the menu button on your device)
  • Find Threema; Xiaomi: drag Threema downwards until the padlock icon appears
  • Tap the padlock icon (the padlock icon will then turn into a closed padlock)

Please note: When using a Xiaomi device, you need to perform these steps again after a restart.

Should the problem persist, please run WebRTC Diagnostics, and send in the result:

  • In Threema, open the main menu and navigate to Settings > About Threema > Troubleshooting > WebRTC Diagnostics, and tap Start
  • Wait until the test is completed, and tap “Copy to Clipboard”
  • Send the copied text along with a short description of the problem to the Threema ID *SUPPORT

We will then analyze the problem and get back to you as soon as we can.

OnePlus

Open the task manager, navigate to Threema, and tap the lock icon (which will close the lock).

iOS

If the iOS device is locked, the battery level is low, or the iOS app is in the background, the desktop app / web client might be slower or less responsive. Connect your device to an external power source, and open the Threema app.

As of version 1.2, the rpm package of Threema for desktop is signed. In order to check the signature during the installation and update process, the public key used for the signature must be imported. In the terminal, the key can be imported by running rpm --import rpm-signing-key.pub. The signature can be verified by running rpm --checksig -v Threema-Latest.rpm.

If the key has not yet been imported, the error message Header V4 RSA/SHA512 Signature, key ID c4e29d69: NOKEY appears.

Show all FAQs

Show all FAQs