Repolode
aaddrick

aaddrick/claude-desktop-debian

Unofficial Linux packaging of Claude Desktop as .rpm, AppImage and Nix flake, plus a launcher and a --doctor diagnostic tool.

Open-source alternative to:Claude Desktop

Stars
5,464
Forks
533
Open issues
9
Last commit
yesterday

What is it?

Claude Desktop for Linux repackages Anthropic's official Linux .deb into formats the vendor does not ship itself: .rpm for Fedora and RHEL, distribution-agnostic AppImages, and a Nix flake for NixOS. Since v3.0.0 the project builds from the official .deb rather than the Windows installer, and its packages are named claude-desktop-unofficial so they can install alongside Anthropic's package.

On top of packaging, the project adds a launcher that handles Linux-specific issues: opt-in native Wayland, GPU-crash recovery, XRDP detection, input-method overrides, and autostart repair. A --doctor command checks the display server, sandbox permissions, MCP configuration, stale locks, KVM and Cowork dependencies, and version drift from the official build.

A small set of patches remains on top of the official app.asar, covering virtiofsd path lookup, the org-plugins path on Linux, tray icon selection on Cinnamon, a Quick Entry focus fix on KDE, and an opt-in bubblewrap backend for Cowork on hosts without KVM.

Key features

  • 01Provides .rpm, AppImage and Nix flake builds of Claude Desktop
  • 02Includes a launcher with opt-in native Wayland and GPU-crash recovery
  • 03Offers a --doctor command that checks display, sandbox, MCP and Cowork setup
  • 04Supports MCP servers through a local configuration file
  • 05Adds a global hotkey and system tray integration on X11 and Wayland

Use cases

  • Installing Claude Desktop on Fedora or RHEL using an rpm package
  • Running Claude Desktop on any distribution through an AppImage
  • Using Claude Desktop on NixOS with a flake-based configuration
  • Troubleshooting display, sandbox or Cowork setup issues on Linux

Quick start

  1. 1

    Add the repository signing key

    curl -fsSL https://pkg.claude-desktop-debian.dev/KEY.gpg | sudo gpg --dearmor -o /usr/share/keyrings/claude-desktop-unofficial.gpg
  2. 2

    Add the APT repository

    echo "deb [signed-by=/usr/share/keyrings/claude-desktop-unofficial.gpg arch=amd64,arm64] https://pkg.claude-desktop-debian.dev stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop-unofficial.list
  3. 3

    Update package lists

    sudo apt update
  4. 4

    Install the package

    sudo apt install claude-desktop-unofficial

Things to know

  • This is an unofficial repackaging; the app itself is Anthropic's and falls under Anthropic's Consumer Terms.
  • Cowork needs KVM hardware virtualization unless you opt into the experimental bubblewrap backend.
  • The project no longer publishes to the AUR, so Arch users must use the community package or the AppImage.

Topics

FAQ

What is claude-desktop-debian?
Unofficial Linux packaging of Claude Desktop as .rpm, AppImage and Nix flake, plus a launcher and a --doctor diagnostic tool. Claude Desktop for Linux repackages Anthropic's official Linux .deb into formats the vendor does not ship itself: .rpm for Fedora and RHEL, distribution-agnostic AppImages, and a Nix flake for NixOS. Since v3.0.0 the project builds from the official .deb rather than the Windows installer, and its packages are named claude-desktop-unofficial so they can install alongside Anthropic's package.
Is claude-desktop-debian free to use? What license does it have?
claude-desktop-debian is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is claude-desktop-debian still maintained?
Actively maintained. The last commit to claude-desktop-debian was on Oct 19, 2026.
What can I use claude-desktop-debian for?
Installing Claude Desktop on Fedora or RHEL using an rpm package Running Claude Desktop on any distribution through an AppImage Using Claude Desktop on NixOS with a flake-based configuration Troubleshooting display, sandbox or Cowork setup issues on Linux
How do I install claude-desktop-debian?
Add the repository signing key: curl -fsSL https://pkg.claude-desktop-debian.dev/KEY.gpg | sudo gpg --dearmor -o /usr/share/keyrings/claude-desktop-unofficial.gpg Add the APT repository: echo "deb [signed-by=/usr/share/keyrings/claude-desktop-unofficial.gpg arch=amd64,arm64] https://pkg.claude-desktop-debian.dev stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop-unofficial.list Update package lists: sudo apt update Install the package: sudo apt install claude-desktop-unofficial
Where can I get claude-desktop-debian?
The source code and installation instructions are on GitHub: https://github.com/aaddrick/claude-desktop-debian

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects