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

# Install services on Windows

> Install the MBKYC desktop services on Windows via Chocolatey or the MSI installer.

Install the [desktop services](/distribution/services-overview) from the MBKYC Nexus repositories. Replace `repo.client.ae` with the host your ICP contact gives you, and use your issued credentials.

<Warning>
  The **Zhiang** and **Suprema BMS-2** fingerprint readers need a WinUSB driver that isn't bundled in the MSI/Chocolatey packages yet — on a stock machine they show `Status=Error` until the driver is installed manually. The **PC/SC** and **Morpho** services install with no custom driver.
</Warning>

## Chocolatey (recommended)

<Steps>
  <Step title="Add the source">
    ```powershell theme={null}
    choco source add --name mbkyc `
      --source "https://repo.client.ae/repository/mbkyc-nuget" `
      --user "your_username" --password "your_password"
    ```
  </Step>

  <Step title="Install">
    ```powershell theme={null}
    choco install mbkyc-pcsc-service mbkyc-morpho-service -y
    ```
  </Step>

  <Step title="Uninstall (when needed)">
    ```powershell theme={null}
    choco uninstall mbkyc-pcsc-service mbkyc-morpho-service -y
    ```
  </Step>
</Steps>

### Available packages

| Package                 | Description                                                                                      |
| ----------------------- | ------------------------------------------------------------------------------------------------ |
| `mbkyc-pcsc-service`    | PC/SC smart card reader service                                                                  |
| `mbkyc-morpho-service`  | Morpho (IDEMIA MSO 1350) fingerprint service                                                     |
| `mbkyc-suprema-service` | Suprema BioMini Slim 2 (BMS-2) fingerprint service — needs the WinUSB driver (see warning above) |
| `mbkyc-zhiang-service`  | NEXUS / Zhiang fingerprint service — needs the WinUSB driver (see warning above)                 |
| `mbkyc-web-host`        | Browser extension native messaging host                                                          |
| `mbkyc-capi`            | C API library                                                                                    |

## MSI installer

Download a service's MSI directly from the raw repository and install it silently:

```powershell theme={null}
$user = "your_username"
$pass = "your_password"
$headers = @{ Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("${user}:${pass}")) }

# Download (replace <VERSION>, e.g. 0.4.0)
Invoke-WebRequest -Headers $headers -OutFile mbkyc-pcsc-service.msi `
  -Uri "https://repo.client.ae/repository/mbkyc-raw/mbkyc/mbkyc-pcsc-service/<VERSION>/windows/msi/mbkyc-pcsc-service-<VERSION>-x86_64.msi"

# Install / uninstall (silent)
msiexec /i mbkyc-pcsc-service.msi /qn
msiexec /x mbkyc-pcsc-service.msi /qn
```

## C API library

For C/C++ and .NET consumers who need the C API on Windows:

<Tabs>
  <Tab title="NuGet">
    ```powershell theme={null}
    nuget sources add -Name mbkyc -Source "https://repo.client.ae/repository/mbkyc-nuget" `
      -Username "your_username" -Password "your_password"
    nuget install MBKYC.Capi -Source mbkyc
    ```
  </Tab>

  <Tab title="vcpkg">
    ```powershell theme={null}
    $headers = @{ Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("your_username:your_password")) }
    Invoke-WebRequest -Headers $headers -OutFile mbkyc-capi-vcpkg.zip `
      -Uri "https://repo.client.ae/repository/mbkyc-raw/mbkyc/mbkyc-capi/<VERSION>/vcpkg/mbkyc-capi-vcpkg-<VERSION>.zip"
    Expand-Archive mbkyc-capi-vcpkg.zip -DestinationPath vcpkg-overlay
    vcpkg install mbkyc-capi --overlay-ports=.\vcpkg-overlay
    ```
  </Tab>
</Tabs>

## Service management

```powershell theme={null}
# Status
Get-Service MBKYCPcscGenericSmartcard
Get-Service MBKYCUsbMorphoFingerprint

# Start / Stop
Start-Service MBKYCPcscGenericSmartcard
Stop-Service  MBKYCPcscGenericSmartcard

# Logs (Event Viewer)
Get-WinEvent -LogName Application `
  -FilterXPath "*[System[Provider[@Name='MBKYCPcscGenericSmartcard']]]" -MaxEvents 50
```