Installation

Install DeepSeek Harness Desktop on Windows, macOS, or Linux.

The desktop installer stays lightweight. On first launch, the app downloads a compatible Node.js runtime and a prebuilt Harness core.

System requirements

Platform	Requirement	Distribution
Windows	Windows 10 or later	NSIS .exe or localized .msi
macOS	macOS 10.15 or later	Apple Silicon/Intel .dmg, Homebrew
Linux	Modern 64-bit distribution	.deb or AppImage

The first launch requires a network connection. After setup, normal work remains local unless a model provider, plugin, or update needs network access.

Install from GitHub Releases

1. Open the release page

   Visit the latest release.

2. Choose an installer

   Download the asset that matches your operating system and architecture. On Linux, prefer .deb when your distribution supports it.

3. Install and launch

   Run the installer, then open DeepSeek Harness Desktop from your application menu.

Install on macOS with Homebrew

brew install dsh-tauri-desk/desktop/deepseek-harness

Platform notes

Windows security prompt

Confirm that the installer came from the official GitHub Release. The application uses WebView2, which is included with supported Windows versions.

macOS blocks the first launch

Verify the download source, then allow the application from System Settings → Privacy & Security.

Black window on Linux Wayland

Prefer .deb. If the AppImage still shows a black window, try:

WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 GDK_BACKEND=x11 ./Deepseek*.AppImage

Released users do not need to install Node.js, pnpm, or Docker. These tools are only required when developing the desktop application from source.

Continue with First run.