Skip to content

docs: add Linux install steps and AppImage troubleshooting#951

Merged
cjpais merged 1 commit intocjpais:mainfrom
arimxyer:docs/linux-build-notes
Mar 4, 2026
Merged

docs: add Linux install steps and AppImage troubleshooting#951
cjpais merged 1 commit intocjpais:mainfrom
arimxyer:docs/linux-build-notes

Conversation

@arimxyer
Copy link
Contributor

@arimxyer arimxyer commented Mar 3, 2026

Summary

  • Add production build step (step 4) to BUILD.md
  • Document the deb extraction method for installing Handy from source on Linux (the binary can't run standalone without Tauri resource files)
  • Add troubleshooting section for the AppImage build failure on rolling-release distros (Arch, CachyOS, Manjaro, etc.) with a workaround (--bundles deb)

Closes #946

Test plan

  • Verify deb extraction install steps work on a clean system
  • Verify bun run tauri build -- --bundles deb skips AppImage and succeeds

🤖 Generated with Claude Code

Document the deb extraction method for installing from source on Linux,
and the AppImage build failure on rolling-release distros (Arch, CachyOS,
etc.) caused by linuxdeploy's bundled strip being too old.

Closes cjpais#946

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@cjpais cjpais merged commit a50c59c into cjpais:main Mar 4, 2026
4 checks passed
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.

AppImage build fails on Arch/rolling-release distros (linuxdeploy strip incompatibility)

2 participants