# Setting x-scheme-handler on linux system to enable forum login via DeltaChat Desktop

**URL:** <https://forum.delta.chat/t/setting-x-scheme-handler-on-linux-system-to-enable-forum-login-via-deltachat-desktop/2794>\
**Category:** Mutual Help\
**Tags:** desktop\
**Created:** [November 14, 2023, 5:08pm UTC](https://forum.delta.chat/t/setting-x-scheme-handler-on-linux-system-to-enable-forum-login-via-deltachat-desktop/2794 "2023-11-14T17:08:47Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![Seth](https://forum.delta.chat/letter_avatar_proxy/v4/letter/s/f14d63/32.png) [@Seth](https://forum.delta.chat/u/Seth)\
**Post date:** [November 14, 2023, 5:08pm UTC](https://forum.delta.chat/t/setting-x-scheme-handler-on-linux-system-to-enable-forum-login-via-deltachat-desktop/2794/1 "2023-11-14T17:08:47Z")

</div>

**Delta Chat version**  
Version 1.40.4 (git: v1.33.0-320-g70746da6)  
**Expected behavior**  
Click on manual link option and DeltaChat opens login link and authenticates to forum via login bot  
**Actual behavior**  
DeltaChat does nothing, does not open link.  
**Steps to reproduce the problem**

1. Visit [support.deltachat.com](http://support.deltachat.com)
2. Select DeltaChat login option
3. Click on manual link button under QR code

**Screen snapshots**  
Will add later  
**Debug logs**

> **Logs**
>
> No logs because DeltaChat is missing mimetype

So for I have tried adding the following to `~/.config/mimetypes`

```auto
[Added Associations]
x-scheme-handler/openpgp4fpr=deltachat.desktop;

```

This will cause DeltaChat to launch, but it still doesn’t load the link.

If I click to button to copy the login link to the clipboard, then navigate via the terminal to the appimage /tmp directory, and manually run this command, the login bot is launched in the desktop app, and it successfully authenticates to the forum.

`./deltachat-desktop 'openpgp4fpr:3D067A8CF3018F4D7F1846C9798306B159C79240#a=delta%2Didentity%40testrun.org&g=LoginBot%20group%2035cb0&x=Wy3r2m1jhjS&i=b3XzIugi1r_&s=qX2t2YI2udv'`

So I think I’m halfway there, I just need to tweak either the deltachat.desktop xdg file, or my mimetype x-scheme-handler and it should work.

Here’s my xdg shortcut contents `.local/share/applications/deltachat.desktop`

Name=DeltaChat (1.40.4)  
Exec=/home/user/Applications/DeltaChat-1.40.4.AppImage  
Terminal=false  
Type=Application  
Icon=deltachat-desktop  
Categories=Messaging

---

<div class="post-metadata">

**Author:** ![Seth](https://forum.delta.chat/letter_avatar_proxy/v4/letter/s/f14d63/32.png) [@Seth](https://forum.delta.chat/u/Seth)\
**Post date:** [November 14, 2023, 5:56pm UTC](https://forum.delta.chat/t/setting-x-scheme-handler-on-linux-system-to-enable-forum-login-via-deltachat-desktop/2794/2 "2023-11-14T17:56:37Z")

</div>

Figured it out with some help from this [Appimage github issue](https://github.com/AppImage/AppImageKit/issues/922)

The secret is to add `%u` to the end of the xdg shortcut exec= line, like so

`Exec=/home/user/Applications/DeltaChat-1.40.4.AppImage %u`

---

<div class="post-metadata">

**Author:** ![Simon](https://forum.delta.chat/user_avatar/forum.delta.chat/simon/32/287_2.png) [@Simon](https://forum.delta.chat/u/Simon)\
**Post date:** [November 14, 2023, 9:44pm UTC](https://forum.delta.chat/t/setting-x-scheme-handler-on-linux-system-to-enable-forum-login-via-deltachat-desktop/2794/3 "2023-11-14T21:44:06Z")

</div>

Is this desktop file included in the app image or where does it come from?  
You can also test with [🧪 Help testing the upcoming 1.41.X release](https://support.delta.chat/t/help-testing-the-upcoming-1-41-x-release/2793), maybe it was a bug in the packaging tool we used that could be already fixed meanwhile?

---

<div class="post-metadata">

**Author:** ![Seth](https://forum.delta.chat/letter_avatar_proxy/v4/letter/s/f14d63/32.png) [@Seth](https://forum.delta.chat/u/Seth)\
**Post date:** [November 15, 2023, 12:43am UTC](https://forum.delta.chat/t/setting-x-scheme-handler-on-linux-system-to-enable-forum-login-via-deltachat-desktop/2794/4 "2023-11-15T00:43:37Z")

</div>

No I homerolled it.

There’s a pretty cool app for Debian based systems called [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher) that will create them automatically for you, but it doesn’t work on Gentoo.

---

<div class="post-metadata">

**Author:** ![r10s](https://forum.delta.chat/user_avatar/forum.delta.chat/r10s/32/1513_2.png) [@r10s](https://forum.delta.chat/u/r10s)\
**Post date:** [October 6, 2026, 3:15pm UTC](https://forum.delta.chat/t/setting-x-scheme-handler-on-linux-system-to-enable-forum-login-via-deltachat-desktop/2794/5 "2026-10-06T15:15:17Z")

</div>