# claude-desktop-debian | Aaddrick | Knowledge Base | Instagit Claude Desktop for Debian-based Linux distributions GitHub Stars: 3.5k Repository: https://github.com/aaddrick/claude-desktop-debian --- ## Articles ### [Self-Referential .mcpb-cache Symlink Bug and bwrap Handling in Claude Desktop Debian](/aaddrick/claude-desktop-debian/self-referential-mcpb-cache-symlink-bug-and-bwrap-handling) Fix the self-referential .mcpb-cache symlink bug in Claude Desktop Debian. Learn how Bubblewrap handles it by detecting and removing the symlink before sandbox bind-mounts. - Tags: internals - Published: 2026-04-19 ### [How to Read Cowork Daemon Logs and Troubleshoot Startup Failures in Claude Desktop](/aaddrick/claude-desktop-debian/how-to-read-cowork-daemon-logs-and-troubleshoot-startup-failures) Troubleshoot Claude Desktop Cowork daemon startup failures by examining the cowork_vm_daemon.log. Learn to grep logs for errors and diagnose initialization crashes or system kills efficiently. - Tags: how-to-guide - Published: 2026-04-19 ### [Protocol Used by Linux cowork-vm-service: Unix Socket & JSON Framing Guide](/aaddrick/claude-desktop-debian/protocol-used-by-linux-cowork-vm-service) Discover the Linux cowork-vm-service protocol. Learn how it uses Unix sockets and JSON framing for efficient inter-process communication on Linux systems. Understand this key aspect of the claude-desktop-debian repository. - Tags: deep-dive - Published: 2026-04-19 ### [Daemon Auto-Spawn Mechanism for Cowork Sessions in Claude Desktop](/aaddrick/claude-desktop-debian/daemon-auto-spawn-mechanism-for-cowork-sessions) Automatically relaunch the cowork vm service with the daemon auto-spawn mechanism. This feature intercepts ECONNREFUSED errors and forks a new process. Ensure seamless Cowork sessions in Claude Desktop. - Tags: internals - Published: 2026-04-19 ### [Guest-Path Translation for Tool Permissions in Claude Desktop Cowork Mode](/aaddrick/claude-desktop-debian/guest-path-translation-for-tool-permissions) Learn how Claude Desktop Debian uses guest-path translation to secure tool permissions and prevent directory-traversal attacks in Cowork Mode. - Tags: internals - Published: 2026-04-19 ### [KDE Quick Window Blur/Hide Patch for Focus Issues in Claude Desktop on Linux](/aaddrick/claude-desktop-debian/kde-quick-window-blur-hide-patch-for-focus-issues) Fix KDE Plasma focus issues with Claude Desktop using a blur/hide patch. This patch ensures the quick-entry window releases focus, allowing the main window to appear seamlessly. - Tags: fix - Published: 2026-04-19 ### [How to Patch Linux Claude Code Binary Support into the Claude Desktop Electron App](/aaddrick/claude-desktop-debian/patches-for-linux-claude-code-binary-support-in-electron-app) Enable Linux Claude Code binary support in the Claude desktop app with platform detection patches and a Nodejs service daemon. Learn how to patch Electron for sandboxed execution. - Tags: how-to-guide - Published: 2026-04-19 ### [AppImage Sandbox Restrictions and Isolation Alternatives for Claude Desktop](/aaddrick/claude-desktop-debian/appimage-sandbox-restrictions-and-isolation-alternatives) Explore AppImage sandbox restrictions for Claude Desktop and discover isolation alternatives like native packages, Bubblewrap containers, or VM backends to enhance security. - Tags: deep-dive - Published: 2026-04-19 ### [Global Hotkey Not Working in Native Wayland Mode: A Technical Fix for Claude Desktop](/aaddrick/claude-desktop-debian/global-hotkey-not-working-in-native-wayland-mode) Fix the global hotkey not working in Wayland for Claude Desktop. Learn why the Ctrl Alt Space shortcut fails and how to enable it. - Tags: how-to-guide - Published: 2026-04-19 ### [Dependencies for Building .deb, .rpm, and AppImage Packages for Claude Desktop](/aaddrick/claude-desktop-debian/dependencies-for-building-deb-rpm-and-appimage-packages) Learn the essential dependencies for building .deb, .rpm, and AppImage packages for Claude Desktop. Master standard Linux packaging tools like dpkg-dev, rpm-build, and appimagetool. - Tags: dependencies - Published: 2026-04-19 ### [How to Build Claude Desktop on Linux Using a Local Windows Installer](/aaddrick/claude-desktop-debian/build-claude-desktop-with-local-windows-installer) Build Claude Desktop on Linux easily using a local Windows installer. Follow our guide to extract the Electron app and package it for Debian, RPM, or AppImage. - Tags: how-to-guide - Published: 2026-04-19 ### [Fix Claude Desktop OAuth Token Cache 401 Authentication Errors](/aaddrick/claude-desktop-debian/fix-claude-desktop-oauth-token-cache-401-authentication-errors) Resolve Claude Desktop OAuth token cache 401 authentication errors by deleting the stale oauth token entry from config json. Get Claude Desktop working again. - Tags: how-to-guide - Published: 2026-04-19 ### [Override Cowork VM Backend Selection with Environment Variable in Claude Desktop](/aaddrick/claude-desktop-debian/override-cowork-vm-backend-selection-with-environment-variable) Force Claude Desktop's VM backend selection using COWORK_VM_BACKEND environment variable. Choose kvm bwrap or host bypassing auto-detection. - Tags: how-to-guide - Published: 2026-04-19 ### [Guest-to-Host Path Translation in Claude Desktop Cowork Mode: Implementation Guide](/aaddrick/claude-desktop-debian/guest-to-host-path-translation-in-cowork-mode) Learn guest-to-host path translation in Claude Desktop Cowork Mode. This guide details the JavaScript layer implementation and security validations for seamless file access. - Tags: how-to-guide - Published: 2026-04-19 ### [How to Fix BubbleWrap Sandbox Failures on Ubuntu 24.04+: The AppArmor Fix](/aaddrick/claude-desktop-debian/bubblewrap-sandbox-fails-on-ubuntu-24-04-apparmor-fix) Fix BubbleWrap sandbox failures on Ubuntu 24.04+ with this AppArmor fix. Create a custom profile to grant necessary capabilities and restore sandbox functionality. - Tags: how-to-guide - Published: 2026-04-19 ### [Claude Desktop `--doctor` Diagnostic Command: Usage, Checks, and Implementation](/aaddrick/claude-desktop-debian/claude-desktop-doctor-diagnostic-command-usage-and-checks) Use claude-desktop --doctor to run a diagnostic check ensuring package integrity, sandbox permissions, and display server config before launching the UI. Fix issues fast. - Tags: how-to-guide - Published: 2026-04-19 ### [How to Build Claude Desktop Debian Packages from a Windows Installer](/aaddrick/claude-desktop-debian/how-to-build-claude-desktop-debian-packages-from-windows-installer) Build claude-desktop Debian packages from a Windows installer. Extract, patch, and repackage the Electron app using provided scripts for Linux compatibility. - Tags: how-to-guide - Published: 2026-04-19