Running Signal desktop app natively on Wayland

rail — Sun, 04 May 2025 00:00:00 +0000

Signal, the private messaging app, ships an Electron-based desktop application available for Windows, Mac and Linux computers.</p>

The Linux version by default does not support Wayland natively and will run through XWayland in a Wayland environment despite generally accepted system-wide configuration that should cause a different behavior.</p>

That is not without a reason. Signal desktop for Linux ships its own packaged Electron build which does not respect $HOME/.config/electron-flags.conf</code> configuration nor has any custom -flags.conf</code> file to pull configuration from. I can speculate this behavior is due to (understandable) security concerns that would come from using external system-wide Electron and its configurations.</p>

In this post I will summarize my journey into configuring Signal to work natively on Wayland and issues I encountered along the way.</p>

Making Signal not use XWayland</h2>

    Note:</strong> At the beginning of writing this blog, I was not aware of Signal actually respecting an environment variable and wanted to suggest a different, more complicated solution. The things you get to know ^^
</div>
Setting ELECTRON_OZONE_PLATFORM_HINT</code> environment variable to "auto"</code> will make Signal start without using XWayland.</p>
This behavior didn’t use to be the case in the past, and since Signal doesn’t respect Electron flags set in a config file, the only option of making it run on Wayland was adding command-line flags directly into the .desktop</code> file. That obviously had its implications for example for window managers such as Sway, because they don’t use those files to start applications.</p>
Usually the easiest way to set up an environmental variable for your system is by creating a file in ~/.config/environment.d/</code> folder. I will assume you never set it up before, so here is what you need to do:</p>
$</span> mkdir ~/.config/environment.d/</span></span>
$</span> echo</span> '</span>ELECTRON_OZONE_PLATFORM_HINT="auto"</span>' >></span> ~/.config/environment.d/variables.conf</span></span></code></pre>
    Note:</strong> This solution only works for distributions using systemd. If you don’t use one of those, I’m sure you know best how to set up env variables on your system!
</div>
After variables from the configuration file are loaded, Signal (and other Electron applications) should start without using XWayland. You can verify that by running xlsclients</code> (signal-desktop</code> should not</strong> appear there).</p>
However, this does not mean there are no issues…</p>
Problems ahead</h2>
There are some</em> problems^{[1]</sup></a> with running Signal natively on Wayland. I will only cover some of them here, consult GitHub if you encounter different ones.</p>}
Problem 1: Starting minimized</h3>

    Note:</strong> Check if GitHub issue #6368</a> hasn’t been fixed at the time of reading. Maybe you don’t need to do anything!
</div>
Trying to run Signal, you may notice it seems to not work initially, or only starts in system tray, not launching the window and you need to start the application twice or more to actually get it running. This might not be a desired behavior and does not normally happen under X11.</p>
This problem can be approached in a few different ways.</p>
Solution 1: JSON config</h4>
The first solution</strong> is changing the maximized</code> key within ~/.config/Signal/ephemeral.json</code> file from false</code> to true</code>.</p>
But this does not fully solve the issue, as contents of ~/.config/Signal/ephemeral.json</code> are overwritten by Signal on every startup. To solve this, you may need to create a script that will be run every time the app is closed or before it is started, setting the window maximization key to true</code> every time.</p>
Solution 2: .desktop</code> file</h4>

    Note:</strong> If you use a window manager, ignore this section entirely and skip to the section below</a> instead.
</div>
Another solution is less elegant and involves modifying the .desktop</code> file used to run the application in a desktop environment. That file controls entries in the application list!</p>
First, you need to copy a system-wide .desktop</code> file and make a local copy of it. Then open it using a text editor:</p>
$</span> cp /usr/share/applications/signal-desktop.desktop ~/.local/share/applications/</span></span>
$</span> nano ~/.local/share/applications/signal-desktop.desktop</span></span></code></pre>
Once you have the file opened, find a line starting with Exec=</code>. It should be somewhere in the upper half of the file. Replace it</strong> with:</p>
Exec</span>=</span>signal-desktop</span> &</span> sleep</span> 1</span> &&</span> signal-desktop</span></span></code></pre>
After saving, you need to update the database of .desktop</code> files:</p>
$</span> update-desktop-database ~/.local/share/applications/</span></span></code></pre>
That should result in the Signal application being called twice, once to start it minimized and once more to make it show up.</p>
Solution 3: Patched build</h4>
Third way</strong> of fixing this is, if available on your distribution, installing signal-desktop-fix-sway</code></a> build of Signal. It does fix this issue. Said package is available for example on Arch Linux through AUR.</p>
Problem 2: Visual glitches</h3>
Running Signal on Wayland not through XWayland may also cause a bunch of different visual glitches such as visual stuttering, glitchy shadows around the window or blurriness (e.g. with UI fractional scaling enabled). Unfortunately I do not know a way of fixing those. We probably need to wait for the developers to fix this :/</p>

If you have any questions, feel free to reach out to me on the fediverse – you can find me there under @rail@flufftech.net</code></a>.</p>

rail - guide

Running Signal desktop app natively on Wayland

Solution 3: Patched build</h4>
Third way</strong> of fixing this is, if available on your distribution, installing `signal-desktop-fix-sway</code></a> build of Signal. It does fix this issue. Said package is available for example on Arch Linux through AUR.</p>`

rail - guide

Running Signal desktop app natively on Wayland

Solution 3: Patched build</h4> Third way</strong> of fixing this is, if available on your distribution, installing signal-desktop-fix-sway</code></a> build of Signal. It does fix this issue. Said package is available for example on Arch Linux through AUR.</p>

Solution 3: Patched build</h4>
Third way</strong> of fixing this is, if available on your distribution, installing `signal-desktop-fix-sway</code></a> build of Signal. It does fix this issue. Said package is available for example on Arch Linux through AUR.</p>`