Skip to content

Fix AppImage crash on Linux due to /dev/shm permission issues#1164

Draft
Copilot wants to merge 4 commits intomasterfrom
copilot/fix-white-window-launcher
Draft

Fix AppImage crash on Linux due to /dev/shm permission issues#1164
Copilot wants to merge 4 commits intomasterfrom
copilot/fix-white-window-launcher

Conversation

Copy link
Contributor

Copilot AI commented Nov 17, 2025

Chromium fails to create shared memory in /dev/shm on certain Linux distributions (e.g., Bazzite) with restrictive permissions, causing the launcher to crash on startup with a white window.

Changes

  • Added --disable-dev-shm-usage flag for Linux AppImage builds in xmcl-electron-app/main/index.ts
  • Applied alongside existing --no-sandbox flag in AppImage detection block
if (process.env.APPIMAGE) {
  app.commandLine.appendSwitch('no-sandbox')
  // Disable /dev/shm usage to avoid permission issues on Linux
  // Some distros (e.g., Bazzite) have restrictive /dev/shm permissions that cause Chromium to crash
  if (process.platform === 'linux') {
    app.commandLine.appendSwitch('disable-dev-shm-usage')
  }
}

This Chromium flag bypasses /dev/shm for shared memory allocation, using alternative memory management instead.

Original prompt

This section details on the original issue you should resolve

<issue_title>WHITE WINDOW</issue_title>
<issue_description>### Is there an existing issue for this?

  • I have searched the existing issues

Launcher Version

0.52.7.1227

Operating System

Linux

Architecture

x64

Current Behavior

open the launcher and appear a white windows and after forcing opening from applet

Expected Behavior

corect launch

Steps To Reproduce

with enviroment descripte below and after done sudo chmod 1777 /dev/shm :

  1. download
  2. run with ui or terminal
  3. error
Image Image

Anything else?

enviroment infos:

Operating System: Bazzite 43
KDE Plasma Version: 6.4.5
KDE Frameworks Version: 6.19.0
Qt Version: 6.9.2
Kernel Version: 6.17.5-ba07.fc43.x86_64 (64-bit)
Graphics Platform: Wayland
Processors: 20 × Intel® Core™ i5-14600KF
Memory: 32 GiB of RAM (31.1 GiB usable)
Graphics Processor: NVIDIA GeForce RTX 3060
Manufacturer: Micro-Star International Co., Ltd.
Product Name: MS-7D98
System Version: 3.0

CPU

Architecture:                            x86_64
CPU op-mode(s):                          32-bit, 64-bit
Address sizes:                           39 bits physical, 48 bits virtual
Byte Order:                              Little Endian
CPU(s):                                  20
On-line CPU(s) list:                     0-19
Vendor ID:                               GenuineIntel
Model name:                              Intel(R) Core(TM) i5-14600KF
CPU family:                              6
Model:                                   183
Thread(s) per core:                      2
Core(s) per socket:                      14
Socket(s):                               1
Stepping:                                1
CPU(s) scaling MHz:                      30%
CPU max MHz:                             3500,0000
CPU min MHz:                             800,0000
BogoMIPS:                                6988,80
Flags:                                   fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge mca cmov pat pse36 clflush dts acpi mmx fxsr sse sse2 ss ht tm pbe syscall nx pdpe1gb rdtscp lm constant_tsc art arch_perfmon pebs bts rep_good nopl xtopology nonstop_tsc cpuid aperfmperf tsc_known_freq pni pclmulqdq dtes64 monitor ds_cpl vmx est tm2 ssse3 sdbg fma cx16 xtpr pdcm pcid sse4_1 sse4_2 x2apic movbe popcnt tsc_deadline_timer aes xsave avx f16c rdrand lahf_lm abm 3dnowprefetch cpuid_fault ssbd ibrs ibpb stibp ibrs_enhanced tpr_shadow flexpriority ept vpid ept_ad fsgsbase tsc_adjust bmi1 avx2 smep bmi2 erms invpcid rdseed adx smap clflushopt clwb intel_pt sha_ni xsaveopt xsavec xgetbv1 xsaves split_lock_detect user_shstk avx_vnni dtherm ida arat pln pts hwp hwp_notify hwp_act_window hwp_epp hwp_pkg_req hfi vnmi umip pku ospke waitpkg gfni vaes vpclmulqdq rdpid movdiri movdir64b fsrm md_clear serialize arch_lbr ibt flush_l1d arch_capabilities
Virtualization:                          VT-x
L1d cache:                               544 KiB (14 instances)
L1i cache:                               704 KiB (14 instances)
L2 cache:                                20 MiB (8 instances)
L3 cache:                                24 MiB (1 instance)
NUMA node(s):                            1
NUMA node0 CPU(s):                       0-19
Vulnerability Gather data sampling:      Not affected
Vulnerability Ghostwrite:                Not affected
Vulnerability Indirect target selection: Not affected
Vulnerability Itlb multihit:             Not affected
Vulnerability L1tf:                      Not affected
Vulnerability Mds:                       Not affected
Vulnerability Meltdown:                  Not affected
Vulnerability Mmio stale data:           Not affected
Vulnerability Old microcode:             Not affected
Vulnerability Reg file data sampling:    Mitigation; Clear Register File
Vulnerability Retbleed:                  Not affected
Vulnerability Spec rstack overflow:      Not affected
Vulnerability Spec store bypass:         Mitigation; Speculative Store Bypass disabled via prctl
Vulnerability Spectre v1:                Mitigation; usercopy/swapgs barriers and __user pointer sanitization
Vulnerability Spectre v2:                Mitigation; Enhanced / Automatic IBRS; IBPB conditional; PBRSB-eIBRS SW sequence; BHI BHI_DIS_S
Vulnerability Srbds:                     Not affected
Vulnerability Tsa:                       Not affected
Vulnerability Tsx async abort:           Not affected
Vulnerability Vmscape:                   Mitigation; IBPB before exit to userspace

sudo journalctl -k > 0
sudo journalctl -k > 0.tar.zst.zip

at line: 1165

ot...

</details>

- Fixes Voxelum/x-minecraft-launcher#1146

<!-- START COPILOT CODING AGENT TIPS -->
---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our [2 minute survey](https://gh.io/copilot-coding-agent-survey).

Copilot AI and others added 2 commits November 16, 2025 20:23
…1158)

* Initial plan

* Add AMD GPU workaround plugin for Windows rendering issues

Co-authored-by: ci010 <8425057+ci010@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: ci010 <8425057+ci010@users.noreply.github.com>
Copilot AI and others added 2 commits November 17, 2025 17:37
…ow crash

Co-authored-by: ci010 <8425057+ci010@users.noreply.github.com>
Co-authored-by: ci010 <8425057+ci010@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix white window issue in launcher Fix AppImage crash on Linux due to /dev/shm permission issues Nov 17, 2025
Copilot AI requested a review from ci010 November 17, 2025 17:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants