Install using EXE (Legacy)

The EXE installer is supported for existing deployments and manual installations. For all new deployments, use the MSI installer instead.

---

The EXE installer is maintained for existing deployments and will be deprecated in a future release. If you are starting a new deployment, see Install using MSI (Recommended).

Installer Package Contents

The EXE installer package received from your 1Kosmos representative contains the following files:

File	Purpose
1KosmosCredentialProvider-.exe	Installer executable
1KosmosInstaller.bat	Batch script for automated installation
REGCONFIG.ini	Registry configuration file

The config.json file is no longer included in the installer package from v2.4.0.0 onwards. All configuration is handled via REGCONFIG.ini and the Windows Registry.

---

Manual Installation

1. Right-click 1KosmosCredentialProvider-<version>.exe and select Run as administrator.

2. Accept the licence agreement and click Next.

3. Review the installation location and click Next.

4. Click Install.

5. When complete, restart the workstation.

6. Click Finish.

Default installation directory: C:\Program Files\1Kosmos\BlockIDCredentialProvider

Log files: C:\Program Files\1Kosmos\BlockIDCredentialProvider\Logs

A restart is required for the Credential Provider to appear on the Windows login screen.

---

Batch Script Installation

The 1KosmosInstaller.bat script automates installation and registry configuration.

Basic installation

1KosmosInstaller.bat -install 1KosmosCredentialProvider-<version>.exe

Installation with registry configuration

Open the REGCONFIG.ini file and add your values:

VaultUrl=sampleurl
VaultUser=sampleuser
VaultUserCredential=samplecred
VaultProxyUrl=sampleurl
VaultProxyApiKey=sampleapikey
RdpDisabled=0
ClearLastUsedProvider=0
DisablePwdOnLogin=0
DisablePwdOnCredUI=0
CommunitySeed_<dns>_<communityName>=<seed value>
ProviderIcon=<full path to .bmp file>
UILogo=<full path to image file>

Then apply the configuration:

1KosmosInstaller.bat -configure REGCONFIG.ini

Install, configure, and restart in one command

1KosmosInstaller.bat -install 1KosmosCredentialProvider-<version>.exe -configure REGCONFIG.ini -restart

Uninstall

1KosmosInstaller.bat -uninstall

• Values in the REGCONFIG.ini file must not contain double quotes. Passwords containing double quotes will cause the script to fail.

• The -install and -uninstall commands cannot be run simultaneously.

• The REGCONFIG.ini file is automatically deleted after the -configure command completes.

• This script can also be used to upgrade an existing installation.