Installation Guide

This guide provides detailed instructions for installing and configuring the Crayonic Credential Manager.

System Requirements

Hardware Requirements

Processor: 1 GHz or faster
RAM: 2 GB minimum, 4 GB recommended
Disk Space: 100 MB for application files
USB Port: For connecting security keys

Software Requirements

Operating System: Windows 10 (1903 or later) or Windows 11
.NET Framework: 4.8 or later
Browser: Microsoft Edge or Google Chrome for authentication flows
Windows WebAuthn API: Included in supported Windows versions

Network Requirements

Internet connection for Entra ID authentication
Outbound access to the following domains:
login.microsoftonline.com
graph.microsoft.com
*.windows.net

Administrative Requirements

Local administrator privileges for installation
Entra ID account with appropriate permissions for application use

Installation Methods

Standard Installation

Download the MSI installer from the official distribution channel
Right-click the MSI file and select "Install" or double-click to run
If prompted by User Account Control, click "Yes" to allow the installation
Follow the on-screen instructions in the installation wizard
Click "Finish" to complete the installation

The application will be installed to C:\Program Files\Crayonic Credential Manager by default, and shortcuts will be created in the Start Menu and on the Desktop.

Silent Installation

For automated deployment in enterprise environments, you can use the following command to install silently:

# Basic silent installation
msiexec /i CrayonicCredentialManager-1.0.0.msi /quiet

# Silent installation with logging
msiexec /i CrayonicCredentialManager-1.0.0.msi /quiet /l*v install_log.txt

# Silent installation with custom installation directory
msiexec /i CrayonicCredentialManager-1.0.0.msi /quiet INSTALLFOLDER="D:\Applications\Crayonic"

Manual Installation

If you need to install the application manually:

Extract the contents of the ZIP archive to a directory of your choice
Run Fido2UI.exe to start the application
Optionally, create shortcuts manually:
Right-click Fido2UI.exe and select "Create shortcut"
Move the shortcut to your desired location (Desktop, Start Menu, etc.)

Post-Installation Configuration

First-Time Setup

Launch the application from the Start Menu or Desktop shortcut
The application will create necessary configuration files on first run
No additional configuration is required for basic functionality

Environment Variables (Optional)

For non-interactive authentication, you can set the following environment variables:

# Set environment variables for the current session
$env:ENTRA_TENANT_ID = "your-tenant-id"
$env:ENTRA_CLIENT_ID = "your-client-id"
$env:ENTRA_CLIENT_SECRET = "your-client-secret"

# To set permanently for the system (requires admin)
[System.Environment]::SetEnvironmentVariable("ENTRA_TENANT_ID", "your-tenant-id", "Machine")
[System.Environment]::SetEnvironmentVariable("ENTRA_CLIENT_ID", "your-client-id", "Machine")
[System.Environment]::SetEnvironmentVariable("ENTRA_CLIENT_SECRET", "your-client-secret", "Machine")

Application Registration in Entra ID (Optional)

If you plan to use non-interactive authentication, you'll need to register an application in Entra ID:

Sign in to the Azure Portal
Navigate to "Azure Active Directory" > "App registrations"
Click "New registration"
Enter a name for the application (e.g., "Crayonic Credential Manager")
Select the appropriate supported account types
Click "Register"
Under "API permissions", add the following permissions:
Microsoft Graph > User.Read
Microsoft Graph > User.ReadBasic.All
Microsoft Graph > UserAuthenticationMethod.ReadWrite.All
Grant admin consent for these permissions
Under "Certificates & secrets", create a new client secret
Note the Application (client) ID, Directory (tenant) ID, and client secret for use with the environment variables

Upgrading from Previous Versions

To upgrade from a previous version:

Download the latest MSI installer
Run the installer
The installer will automatically detect the previous installation and upgrade it
Your settings and configuration will be preserved

Uninstallation

To uninstall the application:

Open "Settings" > "Apps" > "Apps & features"
Find "Crayonic Credential Manager" in the list
Click on it and select "Uninstall"
Follow the on-screen instructions to complete the uninstallation

Alternatively, you can use the following command for silent uninstallation:

msiexec /x CrayonicCredentialManager-1.0.0.msi /quiet

Troubleshooting Installation Issues

Common Installation Issues

Error: "This installation package could not be opened"

Cause: The MSI file may be corrupted or incomplete.

Solution: Re-download the MSI file and try again. Verify the file integrity if a checksum is provided.

Error: "Another version of this product is already installed"

Cause: A previous installation was not properly removed.

Solution: Uninstall the existing version first, then install the new version. If uninstallation fails, use the Microsoft Install/Uninstall Troubleshooter.

Error: ".NET Framework 4.8 is required"

Cause: The required .NET Framework version is not installed.

Solution: Download and install .NET Framework 4.8 from the Microsoft website, then try the installation again.

Installation Logs

If you encounter issues during installation, check the Windows installation logs:

Open Event Viewer (eventvwr.msc)
Navigate to "Windows Logs" > "Application"
Look for events with "MsiInstaller" as the source

For more detailed logging, run the installation with logging enabled:

msiexec /i CrayonicCredentialManager-1.0.0.msi /l*v install_log.txt

This will create a detailed log file that can help identify installation issues.

Getting Help

If you continue to experience installation issues:

Check the Troubleshooting Guide for common solutions
Check for community discussions and reported issues
Contact support at support@crayonic.com with details about your issue and any error messages