Docs / How-to guides

Install on Windows

The .zip for the current version, Chocolatey for managed installs, and the WinFsp setup.

Requirements

Windows binaries are not code-signed yet. SmartScreen shows a warning on first run. Verify the download against SHA256SUMS (see below), then choose "More info" and "Run anyway".

Install from the .zip

The .zip on GitHub always carries the current release:

  1. Download keibidrop-<version>-windows-amd64.zip from GitHub Releases.
  2. Verify it (below), then unzip it to a folder of your choice.
  3. Install WinFsp (below).
  4. Run keibidrop.exe for the app, or use keibidrop-cli.exe and kd.exe from a terminal.

Install with Chocolatey

choco install keibidrop

Chocolatey installs WinFsp automatically as a dependency and puts all three commands on your PATH.

The Chocolatey package can lag behind. New versions wait in community moderation. For the current release, use the .zip above. To upgrade later: choco upgrade keibidrop.

Install WinFsp

WinFsp provides the filesystem driver for the shared folder.

  1. Download the installer from winfsp.dev. WinFsp 2.1, the current stable release, is recommended.
  2. Run the installer.
  3. Reboot once.

The WinFsp 2026 (2.2) line is in beta. It carries FUSE fixes relevant to KeibiDrop and two security fixes. When it goes stable, it becomes the recommended version.

The drive letter

On Windows, the shared folder appears as a drive letter, for example K:.

The mount point must not already exist. WinFsp creates it at connect time and removes it at disconnect. If you set a folder path as the mount point, pick one that does not exist.

To choose the letter, set mount_path in the config file:

mount_path = "K:"

Pick a letter that is free. The config file is at C:\Users\<you>\.config\keibidrop\config.toml. See the configuration reference.

Verify the download

Download SHA256SUMS from the same release page. In PowerShell, in the download folder:

Get-FileHash .\keibidrop-*-windows-amd64.zip -Algorithm SHA256
Select-String windows-amd64 .\SHA256SUMS

The two hash values must match exactly.

Next steps