> ## Documentation Index
> Fetch the complete documentation index at: https://dshtauri.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<Steps>
  <Step title="Open the release page">
    Visit the [latest release](https://github.com/dsh-tauri-desk/deepseek-harness-desktop/releases/latest).
  </Step>

  <Step title="Choose an installer">
    Download the asset that matches your operating system and architecture. On Linux,
    prefer `.deb` when your distribution supports it.
  </Step>

  <Step title="Install and launch">
    Run the installer, then open **DeepSeek Harness Desktop** from your application menu.
  </Step>
</Steps>

## Install on macOS with Homebrew

```bash theme={null}
brew install dsh-tauri-desk/desktop/deepseek-harness
```

## Platform notes

<AccordionGroup>
  <Accordion title="Windows security prompt">
    Confirm that the installer came from the official GitHub Release. The application
    uses WebView2, which is included with supported Windows versions.
  </Accordion>

  <Accordion title="macOS blocks the first launch">
    Verify the download source, then allow the application from
    **System Settings → Privacy & Security**.
  </Accordion>

  <Accordion title="Black window on Linux Wayland">
    Prefer `.deb`. If the AppImage still shows a black window, try:

    ```bash theme={null}
    WEBKIT_DISABLE_COMPOSITING_MODE=1 WEBKIT_DISABLE_DMABUF_RENDERER=1 GDK_BACKEND=x11 ./Deepseek*.AppImage
    ```
  </Accordion>
</AccordionGroup>

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

Continue with [First run](./first-run).