> For the complete documentation index, see [llms.txt](https://docs.bluefletch.com/bluefletch-enterprise/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/bluefletch-launcher-for-windows/getting-started/configuration-guide.md).

# Configuration Guide

The Launcher is configured by a single JSON file:

```
C:\ProgramData\BlueFletch\launcher.json
```

The file is validated against a JSON schema every time it changes. If validation fails, the Launcher shows a **Configuration Error** screen naming the failing property, and it will not start a session until the file is corrected.

A new configuration takes effect the next time the Launcher returns to the login screen (after a logout); in Open Zone mode the session is cycled automatically.

{% hint style="warning" %}
**Important Notes**

* The configuration file is **case-sensitive**, and Windows paths must use double backslashes (for example `"C:\\Windows\\System32\\notepad.exe"`). 
* Configuration might require reference to assets and scripts. These are referenced via file path. Although any local file path can be read, it is recommended to create `C:\ProgramData\BlueFletch\assets`  and `C:\ProgramData\BlueFletch\scripts`  folders and save resources accordingly. 
  {% endhint %}

### Building Configuration

You can find reference sample configurations in the folder  `C:\Program Files\BlueFletch\BlueFletch Launcher\resources\config`  (only available after installation). The file names can help you identify the configuration best suited for your company's IDP and reauthentication method (e.g. *launcherCentralAuthNFC\_OKTA\_WAVEID.json* means Okta IDP with RFIdeas badge reader and Cental Auth Server).

Please note that it is not required to specify configuration during installation and you can reference the aforementioned folder to build your dedicated configuration **after application installation**.

Visit [Technical Guide](https://docs.bluefletch.com/bluefletch-enterprise/product-guides/bluefletch-launcher-for-windows/technical-guide) to find details on configuration fields and to help you modify sample configuration files based on your company's needs. 

### Applying Configuration

 If you need to define and/or modify configuration **post installation**, you can do so by saving or updating `launcher.json`  file in this location: `C:\ProgramData\BlueFletch\`.

This can be done manually or using the following script:

<pre class="language-powershell" data-title="Replaces the configuration on an installed device without reinstalling:"><code class="lang-powershell"><strong>C:\Program Files\BlueFletch\BlueFletch Launcher\resources\setup-scripts\BFEWindowsLauncher_configUpdate.ps1 -ConfigPath "C:\path\to\launcher.json"
</strong></code></pre>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.bluefletch.com/bluefletch-enterprise/product-guides/bluefletch-launcher-for-windows/getting-started/configuration-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.