RVM functionality

RVM functionality is configured through Desktop Owner Settings and Group Policy and Registry Settings. There are a few options, such as shortcuts and splash screens, that can be configured in the application manifest file. These configurations are noted in their individual sections below.

When the OpenFin RVM launches, it parses the desktop owner settings file and overrides any equivalent registry settings, such as assetsUrl, with the settings specified in the desktop owner settings file.


The OpenFin RVM is responsible for deploying itself and all your application’s assets, including the OpenFin Runtime.

You can use the OpenFin installer generator to create an executable file that streamlines the process of installing an application and updating the Runtime. The generated installer can be pre-baked with the application's manifest; it is delivered as a zip file containing the executable. See OpenFin installer for details about the installer generator.

RVM update logic

When the RVM starts (either from an installer or by direct execution), it first checks whether an RVM is already available on the system. The RVM might be started with a payload, that is, a configuration file or command-line arguments.



Only one instance of the RVM can run on a system at any given time.

If OpenFin is not installed, the RVM copies itself to rvmInstallDirectory (defaults to %LOCALAPPDATA%\OpenFin on Windows), and then launches with the specified payload.

If OpenFin is installed and the newly-launched RVM version is older than or the same as the existing RVM version, it terminates itself after it launches the existing RVM with the specified payload.

If OpenFin is installed and the newly-launched RVM version is newer than the existing RVM version, it performs the following process:

  • If the existing RVM is currently running:

    1. Replace the existing RVM with the installer RVM (with payload removed).
    2. Delegate to the running RVM with the specified payload.
  • If the existing RVM is not running:

    1. Replace the existing RVM with the installer RVM (with the payload removed).
    2. Launch with the specified payload.

Application launch

The RVM is responsible for launching OpenFin applications.

To launch an OpenFin-based application, pass the location of the application manifest file to the RVM executable:

$ openfinRVM.exe --config="SERVER_NAME/APP_MANIFEST_FILE"

In this case SERVER_NAME is the network location, and APP_MANIFEST_FILE is the name of the application manifest file, which is typically in JSON format.

When this command is executed, the RVM reads the application manifest file and downloads the specified Runtime from the download location to launch the app.

Learn more about configuring the app manifest file in the Manifest settings topic.

Download of Runtime and application assets

By default, the RVM resolves release channels, and downloads runtimes and newer RVMs from OpenFin’s servers. The RVM can optionally be configured through the desktop owner settings file or the Windows registry to pull these assets from alternative servers, such as ones on your internal network. Use the assetsUrl property within the configuration.

Learn more about hosting Runtimes, RVMs, and app assets in the Hosting assets topic.

Branded shortcuts and splash screens

You can provide an application with customized, branded shortcuts and splash screens by defining the shortcut object property or splashScreenImage string in the application manifest file, as shown in the following code snippets:

shortcut example:

{ ...
  "shortcut": {
      "company": "OpenFin",
      "description": "YourApp",
      "icon": "http://cdn.openfin.co/YourApp/favicon.ico",
      "name": "YourApp",
      "target": ["desktop", "start-menu"],
      "startMenuRootFolder": "foo/bar"
  } ...

splashScreenImage example:

    "splashScreenImage": "http://SERVER/IMAGE_FILE.png",
    "offlineAccess": true,
    "licenseKey": "8f5ac730-b6a4-4b11-a71c-500427190fda",

Semantic versioning for Runtime

The RVM supports semantic versioning for applications tested and verified to run in multiple OpenFin Runtime versions. This feature is especially useful for application providers who need to target OpenFin Runtimes that are hosted within a Desktop Owner’s environment.
Learn more about semantic versioning in the Semantic Versioning topic.

License tracking

The RVM manages sets of information to determine OpenFin usage, including hardware (desktop/machine), and software (app config) data points. Learn more about license tracking in the License usage data topic.

Deep linking

The RVM permits deep linking to an OpenFin application from anywhere that can invoke a “link,” such as a browser, email client, or another OpenFin application. The RVM uses a custom protocol handler to invoke an application, if not already running, and to pass context to a specific location within an OpenFin application via a uniform resource identifier (URI). For information on using the fin or fins scheme, see Deep linking; for information on defining your own protocol scheme and handler, see Manage your own custom protocol.

App logging and encryption

Application logging is invoked by the RVM and allows applications to have their own, separate logs that can be retrieved for later use by the App Provider.

Learn more about log management and encryption in the Log Management topic.

Error reporting

When an error occurs prior to launching an application, the RVM shows an error dialog with the exit code and brief explanation of the issue. More details are written to the application log. Depending on the Desktop Owner Settings and application's configuration the user might have the option to report the error to OpenFin support or the application owner. Below is a list of exit codes used by the RVM and their descriptions.

Exit code descriptions

0Success (All values <100 are non-error conditions)
5Started as child process
6Configuration complete
100Internal error
101No write access
102Invalid arguments
104Invalid app config URI
105No internet connection
106Self-install failed
107Forcefully acquired primary ownership
108Unable to resolve app directory name
109Failed to initialize desktop owner settings
110Failed to start a child process
111Failed to read install mode payload
112Failed to find install mode payload
113Failed to launch child process in install mode
114Failed to auto-update
116Failed to install RVM
117Failed to launch RVM
118Health check timed out
122Insufficient write access to log directory
127RVM health check success
128Partial health check success
129Health check failure
200Failed to remove app
300Failed to load app
302Failed to create app install directory
303Failed to read app config
304Failed to resolve Runtime version
305Failed to install Runtime
306Failed to install Runtime assets
307Failed to install app assets
308Failed to launch app
309Failed to initialize registry configuration
310Failed to initialize Windows Internet (WinINet) API
313Failed to match fuzzy version
314App is not on allowed list
315Runtime is not on allowed list
317Minimum RVM version is not satisfied
318User canceled installation
319Download error
320Services are disabled
321OpenFin protocol is disabled
322Failed to certify app


As of version, the RVM relays diagnostic information to OpenFin. This diagnostic information pertains to RVM startup, installation, app delegation, auto-update, exit, and errors.

This information is collected to solely support the development of the RVM and streamlines the error support process.

Command line options

The following options are supported by OpenFinRVM.exe (as of RVM version 8):

--configStringThe location of an application manifest to install or start an application
--diagnosticsBooleanEnable diagnostics
--do-not-launch or --dnlBooleanInstall the application without launching it
--enable-ssl-validationnoneRun with HTTPS security enforcement, regardless of security-related registry values
--health-checkStringRun the RVM in health-check mode
--helpnoneDisplay help information about command line options
--nameStringName of an application from the Application Directory to install or start
--no-uiBooleanRun the RVM without progress or error dialogs
--only-self-installBooleanRVM only installs itself, not an application, ignoring any --config argument
--remove-appnoneRemove an application (specified by --config) from the system
--runtime-argumentsStringAdd or replace runtime arguments to launch the application manifest with
--runtime-health-check (RVM 9+)StringRun a health check on the Runtime version specified in the string argument, which must be a specific dotted version number, not a release channel name; the minimum supported version is
--support-emailemail addressCustomize error messages using the specified email address. Default is [email protected]
--versionnoneDisplay the RVM version