Skip to content

Fix Linux sandbox crash and add installation docs#384

Open
antonlobanovskiy wants to merge 1 commit into
ThePacielloGroup:mainfrom
antonlobanovskiy:linux-support-improvements
Open

Fix Linux sandbox crash and add installation docs#384
antonlobanovskiy wants to merge 1 commit into
ThePacielloGroup:mainfrom
antonlobanovskiy:linux-support-improvements

Conversation

@antonlobanovskiy

Copy link
Copy Markdown

Summary

  • Fix SUID sandbox crash on Linux — Adds an afterPack hook (build/linux-sandbox-fix.js) that wraps the Electron binary in a shell script passing --no-sandbox, and removes chrome-sandbox. This fixes the fatal setuid_sandbox_host.cc error on Ubuntu 24.04+, Fedora 41, and other modern distros where AppArmor restricts unprivileged user namespaces.
  • Remove rpm from default Linux build targets — Building RPM requires rpmbuild which most contributors/users won't have installed, causing the build to fail. AppImage and deb cover the vast majority of Linux users.
  • Update README with Linux support — Adds an Installation section documenting FUSE2 dependency for AppImage users (libfuse2t64 on Ubuntu 24.04+), extraction alternative, and updates the features list to reflect Linux picker support.

Context

Tested on Ubuntu 24.04 (kernel 6.17, AppArmor restricting unprivileged userns). The AppImage builds and launches without any --no-sandbox workaround needed from the user.

Related issues: #87, #362

Test plan

  • Build on Linux with npx electron-builder --linux AppImage
  • Verify the built AppImage launches without sandbox errors
  • Verify dist/linux-unpacked/cca is the wrapper script and cca.bin is the real binary
  • Verify chrome-sandbox is removed from the unpacked directory
  • Verify macOS and Windows builds are unaffected (hook checks electronPlatformName)

🤖 Generated with Claude Code

…lation

- Add afterPack hook that wraps Electron binary with --no-sandbox flag
  and removes chrome-sandbox, fixing the SUID sandbox crash on Linux
  (Ubuntu 24.04+, Fedora, etc.)
- Remove rpm from default Linux targets (requires rpmbuild)
- Update README to mention Linux support and add installation instructions
  including FUSE2 dependency for AppImage users

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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.

1 participant