Install VDS on Windows
Step-by-step guide to download, install, configure, and validate the Credence ID VDS service on Windows 10/11. Covers VDS-only and VDS + Form Fill setups.
Prerequisites
Ensure the following are in place before running the VDS installer.
- Tap2iD device connected to your Windows 10/11 PC via USB
- Windows 10/11 PC — Administrator account access required
- VDS installer — Download VDS Installer
Steps to Install VDS Only
Follow the steps below to install the VDS service on your Windows machine.
Download and unzip the installer
Download the VDS Installer and unzip it to a local folder.
Run the installer as Administrator
Navigate to the CredenceID_VDS_Installer_v3.2.2 folder, right-click CredenceID_VDS_Installer_v3.2.2 and select Run as Administrator.
Bypass Windows SmartScreen
If Windows Defender SmartScreen appears, click More Info then Run anyway.
Approve User Account Control
Click Yes on the User Account Control (UAC) prompt to allow the installation to proceed.
Validate the VDS Service
After installation and restart, confirm the VDS service is running correctly.
C:\Program Files\CredenceIDOpen Windows Services
Press Win + R, type services.msc, and press Enter.
Search for CredenceID_VDS_Service
Locate CredenceID_VDS_Service in the list. Its status should show Running.
Stop, Pause, or Restart the service
Use the options on the left panel of the Services window to manage the VDS service lifecycle.
Configuration & Logs
Important file locations and default settings for the VDS service.
-
Logs are generated under
C:\Program Files\CredenceID\logs -
Config file:
C:\Program Files\CredenceID\app\config\application.properties - Any config change requires a service restart
-
VDS Server default port number:
4215 -
WinUSB Driver installer logs:
C:\Users\<profile>\Documents\Credence_WinUSB_log
Navigate to C:\Program Files\CredenceID\app\config and open application.properties as Administrator. Update the following parameter:
server.port=4215Save the file and restart the VDS service for the change to take effect.
In application.properties, update the following parameter:
server.ssl.enabled=falseSave the file and restart the VDS service.
In application.properties, update the following parameters to point to your external keystore:
server.ssl.key-store=file:C://certs//external_keystore.p12
server.ssl.key-store-type=PKCS12
server.ssl.key-alias=localhostThe keystore password is read from Windows Credential Manager. Since VDS runs as a Windows Service under the Local System account, the keystore password must be stored using that account. Follow these steps:
Download PsTools
Download PsTools from the official Microsoft Sysinternals page.
Open Command Prompt as Administrator
Navigate to the folder where PsTools was downloaded and open Command Prompt in Administrator mode.
Run the PsExec command
Execute the following command to store the keystore password:
PsExec.exe -s /accepteula cmdkey /generic:CredenceID_VDS_Credential /user:vds /pass:<external_keystore_password>Known Installer Issues & Workarounds
VDS Installation Issue — PsTools Blacklisted by Anti-Virus
The VDS installer uses PsTools to store the SSL keystore password into Windows Credential Manager using the Local System account. If the system anti-virus has blacklisted PsExec, the installation will fail.
C:\Users\<user>\AppData\Local\Temp\CredenceID\installable
Steps to Uninstall VDS
Open Add or Remove Programs
Go to System Settings → Apps → Add or Remove Programs.
Select CredenceID_VDS
Find and select the app named CredenceID_VDS in the list.
Uninstall the app
Click Uninstall and follow the prompts to complete removal.
Upgrade Procedure
- VDS only installer supports in-place upgrade — simply run the new installer version.
- VDS + Form Fill installer does not support upgrade yet. As a workaround, go to Add or Remove Programs and manually uninstall both VDS and Form Fill separately before running the new installer version.