Skip to content
Back to search

claude-desktop-fedora

Claude Desktop for Fedora 44 — native RPM built from Anthropic's official Linux x86_64 build. Unmodified upstream payload, Chromium sandbox on, Claude Code + Cowork + MCP working.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dewzor--claude-desktop-fedora/badge.svg)](/listings/dewzor--claude-desktop-fedora)

HTML

<a href="/listings/dewzor--claude-desktop-fedora"><img src="/api/listings/dewzor--claude-desktop-fedora/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

sudo dnf install rpm-build binutils file xz curl

git clone https://github.com/dewzor/claude-desktop-fedora.git
cd claude-desktop-fedora
./build-official.sh
sudo dnf install build/official/claude-desktop-*.rpm

Launch **Claude** from your application menu, or run `claude-desktop`. The launcher also ships two desktop actions: *New Chat* and *New Claude Code Session*.

The build runs entirely as your own user; root is only needed for the final `dnf install`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 229 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Claude Desktop for Fedora 44
  2. Install **Claude Desktop on Fedora 44** as a native RPM, built from Anthropic's **official Linux x86_64 build**. Unmodified upstream payload, Chromium sandbox on, Claude Code and Cowork working. Tested on Fedora 44 with KDE Plasma (Wayland) and GNOME (Wayland); should work on Fedora 43 and later.
  3. **TL;DR:** `./build-official.sh && sudo dnf install build/official/claude-desktop-*.rpm`
  4. > Unofficial packaging. Anthropic ships the app; this repo only rewraps it for `dnf`. If you hit a packaging bug, open an issue here, not with Anthropic.
  5. ## Install Claude Desktop on Fedora 44
  6. ```bash
  7. sudo dnf install rpm-build binutils file xz curl gnupg2
  8. git clone https://github.com/dewzor/claude-desktop-fedora.git
  9. cd claude-desktop-fedora
  10. ./build-official.sh
  11. sudo dnf install build/official/claude-desktop-*.rpm
  12. ```
  13. Launch **Claude** from your application menu, or run `claude-desktop`. The launcher also ships two desktop actions: *New Chat* and *New Claude Code Session*.
  14. The build runs entirely as your own user; root is only needed for the final `dnf install`.
  15. ## Auto-updates via COPR
  16. ```bash
  17. sudo dnf copr enable dewzor/claude-desktop
  18. sudo dnf install claude-desktop-builder
  19. ```
  20. `claude-desktop-builder` is a small MIT-licensed package. It does not contain Claude Desktop, and it never will. Claude Desktop is proprietary, so no repository is allowed to ship it. What the package ships is the build itself: `build-official.sh`, a `claude-desktop-update` command, and a systemd timer.
  21. The timer runs once a day. It asks Anthropic's signed apt index which Linux build is current, and checks the signature against Anthropic's release key. If that build is already installed and was built here from that exact signed `.deb`, it stops there and doesn't download the app. If a newer build has shipped, it fetches Anthropic's own `.deb` on your machine, repackages the payload as an RPM, and installs it with `dnf`. You get exactly the package `build-official.sh` produces by hand, without having to remember to run it.
  22. Run it yourself any time:
  23. ```bash
  24. sudo claude-desktop-update --check # says whether a new build exists
  25. sudo claude-desktop-update # rebuilds and installs if there is one
  26. ```
  27. Removing the package leaves Claude Desktop alone:
  28. ```bash
  29. sudo dnf remove claude-desktop-builder
  30. ```
  31. ## What works on Fedora 44
  32. | Feature | Status |
  33. | --- | --- |
  34. | Fedora 44, KDE Plasma (Wayland) | Tested |
  35. | Fedora 44, GNOME (Wayland) | Tested |
  36. | Claude Code tab (integrated terminal) | Working |
  37. | Cowork | Working |
  38. | MCP (Model Context Protocol) | Working |
  39. | Chrome extension MCP bridge | Working |
  40. | Native window frame | Yes, no patching needed |
  41. | Chromium sandbox | Enabled (`chrome-sandbox` setuid 4755, no `--no-sandbox`) |
  42. | System tray | Working |
  43. | GNOME Activities search ("Ask Claude") | Working |
  44. | Open `.mcpb`, `.dxt` and `.skill` files in Claude | Working |
  45. | Auto-download latest Claude | Yes, from Anthropic's signed apt repository |
  46. | Architecture | x86_64 only (see FAQ) |
  47. | Auto-update | Optional, via the `claude-desktop-builder` COPR package |
  48. ## How the Fedora RPM is built
  49. Anthropic publishes an official Linux build of Claude Desktop, but only as a `.deb`. The payload inside is ordinary, self-contained Linux content under `/usr/lib/claude-desktop`. Nothing in it is Debian-specific except the wrapper and dependency names.
  50. `build-official.sh`:
  51. 1. Fetches the `InRelease` index of Anthropic's apt repository and checks its signature against Anthropic's release key. The script pins the key by fingerprint, `31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE`, the one in the Claude Code setup docs. It refuses an index past its `Valid-Until` date, so an old index can't be replayed once it expires (as long as the system clock is right)
  52. 2. Checks the `Packages` index against the SHA256 in the signed index and picks the newest `claude-desktop` entry
  53. 3. Downloads that `.deb`, about 175 MB, and checks it against the SHA256 in the signed index
  54. 4. Unpacks it and checks that the control file's version matches the signed index
  55. 5. Verifies that `@ant/claude-native` and `node-pty` are real ELF x86-64 objects, and fails loudly if not
  56. 6. Maps the Debian dependencies to Fedora package names
  57. 7. Builds an RPM with `rpmbuild`, preserving `chrome-sandbox` setuid via `%attr(4755,root,root)`
  58. 8. Confirms the setuid bit survived into the package metadata
  59. The payload is **unmodified upstream content**. No `app.asar` patching, no stubs, no injected CSS, no launcher wrapper.
  60. At install time the upstream `postinst` also copies three things out of `resources/`. It has to, because electron-installer-debian, which builds the `.deb`, can't ship extra files. The RPM packages them as ordinary files, so `dnf remove` cleans them up:
  61. - the GNOME Shell search provider, `com.anthropic.Claude.search-provider.ini` plus its D-Bus service, which adds an "Ask Claude" result to Activities search
  62. - the MIME types for `.mcpb`/`.dxt` desktop extensions and `.skill` files, so they open in Claude
  63. - the `/usr/bin/ccd` launcher link, when the build ships `resources/bin/ccd`
  64. Two Debian-specific `postinst` behaviours are intentionally dropped:
  65. - The AppArmor `flags=(unconfined)` userns profile. That one is only needed on Ubuntu 24.04+, which restricts unprivileged user namespaces. Fedora leaves them enabled.
  66. - apt repository registration.
  67. ### Options
  68. ```
  69. --deb PATH Use an already-downloaded .deb instead of fetching it. Skips verification.
  70. --outdir DIR Where to write the finished RPM (default: ./build/official).
  71. --release N RPM release field (default: 1).
  72. --keep Keep the build tree for inspection.
  73. --print-latest Verify the signed index, print "VERSION SHA256 FILENAME" for the
  74. newest build, and exit without downloading it.
  75. ```
  76. ## Updating Claude Desktop on Fedora
  77. The RPM does not auto-update. To pick up a new release:
  78. ```bash
  79. ./build-official.sh
  80. sudo dnf install build/official/claude-desktop-*.rpm
  81. ```
  82. The spec carries `Obsoletes: claude-desktop < %{version}-%{release}`, so a newer build cleanly replaces any earlier locally-built package, including ones from the legacy script.
  83. ## MCP setup on Fedora
  84. MCP servers are configured at:
  85. ```
  86. ~/.config/Claude/claude_desktop_config.json
  87. ```
  88. Same format as macOS and Windows Claude Desktop. Drop in your `mcpServers` block and restart the app.
  89. Logs live in `~/.config/Claude/logs/` (`main.log`, `mcp.log`, `ssh.log`, …).
  90. ## Why not the Windows repack any more?
  91. Earlier versions of this repo (`build-fedora.sh`, still in the tree) rebuilt Claude Desktop from the **Windows installer**: extract `app.asar`, swap the native module for a JS stub, patch the titlebar constants, bundle Electron 37. That worked through the 0.14.x era. Current releases can't be served that way:
  92. - **`@ant/claude-native`** is now hard-required for filesystem containment, and the app explicitly refuses to degrade without it:
  93. `@ant/claude-native is required for safe-fs containment but failed to load; refusing to fall back to a path-based open (CC-2885)`.
  94. A JS stub can't satisfy that, and the module also moved from `claude-native` to `@ant/claude-native`, so the old stub path is never even loaded. In a Windows repack the real module is a PE32+ DLL: `ERR_DLOPEN_FAILED: invalid ELF header`.
  95. - **`node-pty`**: Claude Code's terminal needs `prebuilds/linux-x64/pty.node`. The Windows package only ships `prebuilds/win32-x64/conpty.node`.
  96. Net effect: the app starts, but **the Claude Code tab does not work**. The official Linux build ships both modules as real ELF x86-64 objects, and its native frame is already correct, so none of the old patching is needed.
  97. ## Troubleshooting on Fedora 44
  98. Exact error strings and what they mean. All of these are fixed by building with `build-official.sh`.
  99. ### `@ant/claude-native is required for safe-fs containment but failed to load` / `CC-2885`
  100. You're running a Windows-repack build (`build-fedora.sh` or any of the older Fedora scripts). Current Claude Desktop hard-requires the real native module and refuses to start Claude Code without it. Rebuild from the official Linux build.
  101. ### `ERR_DLOPEN_FAILED: invalid ELF header` / `Failed to load Claude Native`
  102. The `claude-native-binding.node` in your install is a Windows PE32+ DLL, not a Linux ELF object. Same cause as above, a Windows repack. Rebuild with `build-official.sh`; it verifies both native modules are ELF x86-64 before packaging.
  103. ### Claude Code tab not working / blank / terminal never appears
  104. Claude Code's terminal needs `node-pty`'s `prebuilds/linux-x64/pty.node`. Windows packages only ship `win32-x64/conpty.node`. Rebuild from the official Linux build and check `~/.config/Claude/logs/main.log` for `[CCD] Initialized`.
  105. ### `⚠ titleBarStyle pattern not found` during `build-fedora.sh`
  106. The legacy script's titlebar `sed` no longer matches current releases. It's harmless but it's also a sign you're on the wrong path. The official build already draws a correct native frame. Use `build-official.sh`.
  107. ### `InRelease is not signed by Anthropic's release key` / `signature check failed`
  108. The apt index didn't verify against the pinned key, or it was signed with an expired or revoked key. Don't work around this with `--deb`. Check https://code.claude.com/docs/en/desktop-linux and the key at https://downloads.claude.ai/claude-desktop/key.asc for a key change, and open an issue.
  109. ### The daily update stopped working
  110. Run `journalctl -u claude-desktop-update.service` to see the last error. Every check fails closed: nothing is installed and the old version keeps working until the next run succeeds.
  111. ### `the signed index expired`
  112. The index is past its `Valid-Until` date, which Anthropic sets a week after signing it. Either the repository hasn't been re-signed in that time, or your system clock is wrong. Check the clock first.
  113. ### `'--ozone-platform=wayland' is not compatible with Vulkan`
  114. Chromium noise on Wayland sessions. Cosmetic; ignore.
  115. ### Cowork says the VM sandbox is unavailable
  116. Install the optional VM stack: `sudo dnf install qemu-system-x86 edk2-ovmf virtiofsd`. The RPM lists these as `Suggests:`.
  117. ### Package conflicts with `claude-desktop-unofficial`
  118. That's [aaddrick/claude-desktop-debian](https://github.com/aaddrick/claude-desktop-debian)'s RPM, which adds a launcher wrapper and a `--doctor`. Both packages share `~/.config/Claude`, so run one or the other, not both.
  119. ## Legacy: `build-fedora.sh`
  120. Kept for anyone who needs a 0.14.x-era build. It is no longer the recommended path and is not maintained against current releases.
  121. ```bash
  122. sudo dnf install rpm-build p7zip nodejs npm
  123. sudo ./build-fedora.sh
  124. sudo dnf install build/electron-app/$(uname -m)/claude-desktop-*.rpm
  125. ```
  126. Known limits on current releases: the Claude Code tab doesn't work (see above), and the `titleBarStyle` sed no longer matches (`⚠ titleBarStyle pattern not found`). History of what it did and why is in [CHANGELOG.md](CHANGELOG.md).
  127. ## FAQ
  128. ### Does Claude Desktop work on Fedora 44?
  129. Yes, tested on Fedora 44 with KDE Plasma (Wayland) and GNOME (Wayland).
  130. ### Does it work on Fedora 43 or older?
  131. It should. The payload is self-contained (bundled Electron), so the only real constraint is the runtime dependency list, which resolves on 43. Not actively tested. If you try it, open an issue with what you see.
  132. ### Does the Claude Code tab work?
  133. Yes. That's the whole point of the official-build path. Look for `[CCD] Initialized` in `~/.config/Claude/logs/main.log`.
  134. ### Does Cowork work?
  135. Yes. Cowork's optional full-VM sandbox needs `qemu-system-x86`, `edk2-ovmf` and `virtiofsd`; they're listed as `Suggests:` in the RPM and are harmless to omit.
  136. ### Does MCP work?
  137. Yes. Config lives at `~/.config/Claude/claude_desktop_config.json`.
  138. ### Why x86_64 only?
  139. The script only builds for x86_64 for now. An `arm64` build exists in Anthropic's apt repo; if you need it, fetch that `.deb` yourself and pass it in with `--deb PATH` (the script currently refuses non-x86_64 hosts, patches welcome).
  140. ### I see a Wayland/Vulkan warning in the logs
  141. `'--ozone-platform=wayland' is not compatible with Vulkan` is Chromium noise. It's cosmetic.
  142. ### How do I uninstall Claude Desktop from Fedora?
  143. ```bash
  144. sudo dnf remove claude-desktop
  145. ```
  146. ## Credits
  147. - [@bsneed](https://github.com/bsneed) (Brandon Sneed): the original project this one grew out of.
  148. - [@boujuan](https://github.com/boujuan) (Juan Boullosa): the Fedora 43 title bar fixes and automatic download of the latest version in the legacy script (v6 to v8).
  149. - [@anilsrml](https://github.com/anilsrml) (Anıl Sürmeli): found and fixed the locale bug that broke builds on Turkish and other systems ([#8](https://github.com/dewzor/claude-desktop-fedora/pull/8)).
  150. - [@arcanistzed](https://github.com/arcanistzed): download verification against Anthropic's signed apt repo, GNOME search and file associations ([#6](https://github.com/dewzor/claude-desktop-fedora/pull/6)).
  151. - [@itsnitinr](https://github.com/itsnitinr): multithreaded zstd payload compression ([#5](https://github.com/dewzor/claude-desktop-fedora/pull/5)).
  152. - [@sharpandpearl](https://github.com/sharpandpearl): `build-official.sh` and the analysis of why the Windows repack stopped working ([#4](https://github.com/dewzor/claude-desktop-fedora/pull/4)).
  153. - [@randy-johnson](https://github.com/randy-johnson): `titleBarOverlay` regex fix on the legacy script ([#3](https://github.com/dewzor/claude-desktop-fedora/pull/3)).
  154. - [@gordonmessmer](https://github.com/gordonmessmer): the [com.anthropic.Claude](https://github.com/gordonmessmer/com.anthropic.Claude) Flatpak manifest that our earlier Flatpak was based on.
  155. ## License
  156. Dual-licensed under MIT and Apache 2.0. See [LICENSE-MIT](LICENSE-MIT) and [LICENSE-APACHE](LICENSE-APACHE).
  157. The Claude Desktop application is not included in this repository and is covered by [Anthropic's Consumer Terms](https://www.anthropic.com/legal/consumer-terms).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.