Skip to content

[FEATURE] Provide official Linux AppImage builds (x86_64 + aarch64) #378

@newyorkthink

Description

@newyorkthink

Title
[FEATURE] Provide official Linux AppImage builds (x86_64 + aarch64)

Body (copy/paste into the issue description)

Feature Summary

Please provide official Linux AppImage packages for this project, published alongside existing releases (e.g., on GitHub Releases). A single self-contained AppImage would make installation and updates significantly easier across a wide range of Linux distributions.

Problem / Use Case

Right now, installing the desktop app on Linux can be difficult depending on the distro (packaging formats, dependencies, sandboxing quirks, missing repos, etc.). Many users want a “download → run” option that works on:

  • Arch / Manjaro
  • Debian / Ubuntu / Mint
  • Fedora / RHEL-based distros
  • NixOS (often still usable with AppImage + workarounds)
  • Minimal systems where Flatpak/Snap aren’t preferred or available

AppImage is a common, distro-agnostic format that reduces support burden and makes onboarding easier.

Proposed Solution

Add CI packaging for AppImage and publish artifacts for each stable release:

  • AppName-x86_64.AppImage
  • AppName-aarch64.AppImage (if feasible)

Suggested requirements:

  • Built in CI (GitHub Actions)
  • Uploaded to GitHub Releases automatically on tags
  • Provide checksums (SHA256SUMS) and optionally GPG signatures
  • Include .desktop + icon integration where appropriate
  • Prefer stable runtime compatibility (e.g., build on an older glibc baseline or use recommended AppImage tooling)

Current Workaround

Users currently have to rely on:

  • Building from source
  • Distro-specific packaging (if any)
  • Manual dependency troubleshooting / repackaging

These workarounds increase friction and lead to repeated support requests.

Detailed Description

User Interface

No UI changes needed. This is purely a distribution/packaging improvement.

Integration Points

Would integrate with:

  • GitHub Actions CI
  • GitHub Releases

Additional Notes / Acceptance Criteria

  • Downloading the AppImage from Releases should work on common distros without extra steps.
  • The AppImage should run without requiring users to install additional libraries beyond typical base system components.
  • If sandboxing is relevant (e.g., Electron), document any required flags or portal dependencies.

Thanks! Having an official AppImage would greatly improve the Linux installation experience and reduce packaging fragmentation.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions