Koravo Messenger

RMM & MSP Deployment Guide

This guide details the process for performing a silent, automated, and custom-branded installation of the Koravo Messenger client application on end-user machines.

Core Concept: Unattended Installation

The Koravo Messenger installers are built to support silent, unattended installations. This allows an RMM or scripting engine to deploy the software without requiring any user interaction. During this silent installation, you can pass parameters to pre-configure the application with custom branding.

Deployment Methods

We officially support three primary methods for automated deployment: PowerShell, Chocolatey, and Command Prompt.

Method 1: PowerShell (Recommended)

This is the most robust method for deployment in a modern Windows environment.

# --- Script Variables ---
# The full network or local path to the installer file.
$InstallerPath = "C:\RMM\Installers\KoravoMessengerClient-1.0.0.exe"

# The desired brand name for your client.
$ClientBrandName = "Martinez Agency Secure Chat"

# [Optional] The URL to the client's logo for future use.
$ClientLogoURL = "https://example.com/logos/martinez_logo.png"

# --- Execution ---
# Construct the arguments string for the installer.
$Arguments = "/S /BRANDNAME=`"$ClientBrandName`" /LOGOURL=`"$ClientLogoURL`""

# Execute the installer silently and wait for it to complete.
Start-Process -FilePath $InstallerPath -ArgumentList $Arguments -Wait -PassThru

Method 2: Chocolatey (for RMMs)

This is the ideal method for RMMs and environments that use Chocolatey. It requires you to host a Chocolatey package (`.nupkg`) on a public or private feed. The command uses Chocolatey's `--params` switch to pass our custom arguments directly to the installer.

# --- Script Variables ---
$ClientBrandName = "Martinez Agency Secure Chat"
$ClientLogoURL = "https://example.com/logos/martinez_logo.png"

# --- Execution ---
# The '/S' is handled by Chocolatey. We only need to pass our custom parameters.
$InstallerParameters = "'/BRANDNAME=""$ClientBrandName"" /LOGOURL=""$ClientLogoURL""'"

# Run the Chocolatey install command.
choco install koravo-messenger -y --params $InstallerParameters

Method 3: Basic Command Prompt (CMD)

This can be used for simpler scripting or manual testing.

"C:\Path\To\Installers\KoravoMessengerClient-1.0.0.exe" /S /BRANDNAME="Martinez Agency Secure Chat" /LOGOURL="https://example.com/logos/martinez_logo.png"

How It Works & Verification

  1. Installation: When the installer is run with these arguments (either directly or via Chocolatey), a script writes the `BRANDNAME` and `LOGOURL` values to the end-user's Windows Registry at `HKEY_CURRENT_USER\Software\Koravo\MessengerClient`.
  2. First Launch: The very first time the Koravo Messenger application is launched by that user, it checks this registry key.
  3. Branding: If it finds the `BRANDNAME` value, it saves this as the new default name for the application and updates its window title accordingly.

This process is fully automated and requires no action from the end-user, providing a seamless, custom-branded experience.