> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/browser-and-browser-profiles/troubleshooting/browser-doesnt-launch.md).

# Browser won't launch

If a browser profile won't open, the browser installation is likely missing or corrupted, and there are 2 ways to fix it. The first option is to **force install** **from inside the app**. If the download fails or the browser still won't launch afterward, there is a second option of **installing the browser files manually**.

### Option 1: Force install from the app

Incogniton can download and reinstall any browser version directly from inside the app, with a progress bar in the install window showing the download status as it runs.

{% stepper %}
{% step %}
**Open Debug tools**

Navigate to **Settings** in the left sidebar of the , then select the **Debug tools** tab.
{% endstep %}

{% step %}
**Select a browser version**

Under **Browser**, find the **Force install/update a specific browser version** section, open the dropdown, and select the version you want to install.

<div data-with-frame="true"><figure><img src="/files/2SOWu17R1h7Yxtl4Eynr" alt=""><figcaption></figcaption></figure></div>

If you're not sure which version to choose, go with the version currently assigned to your profiles, or the latest available version.
{% endstep %}

{% step %}
**Run the installation**

Click **Install / Update** and a modal will appear showing the selected version alongside its changelog. Click **Update now** to start the download, then wait for the progress bar to finish before closing the window.

<figure><img src="/files/PM3VQIbjUmIaC8zwYqK7" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Test the result**

Once the download finishes, try launching a browser profile to confirm everything is working. If it opens, you're done. If the download fails or the browser still won't launch, move on to Option 2.
{% endstep %}
{% endstepper %}

### Option 2: Manual installation

This option involves downloading the browser files directly and placing them in the correct location on your machine. You'll also need to set a version identifier file that Incogniton uses to recognize the installation.

Start by finding your browser version in the table below. Then note the **VERSION.txt value** and the download link for your platform, you'll use both in the steps that follow.

<table data-search="false"><thead><tr><th>Version</th><th>VERSION.txt value</th><th>Windows 64-bit</th><th>Windows 32-bit</th><th>Mac Intel</th><th>Mac ARM</th></tr></thead><tbody><tr><td>149</td><td>1.0.0.3</td><td><a href="https://www.incogniton.com/149IncognitonWindows64Browser">Download</a></td><td><a href="https://www.incogniton.com/149IncognitonWindows32Browser">Download</a></td><td><a href="https://www.incogniton.com/149IncognitonMacBrowser">Download</a></td><td><a href="https://www.incogniton.com/149IncognitonMacBrowserArm">Download</a></td></tr><tr><td>146</td><td>1.1.0.1</td><td><a href="https://www.incogniton.com/146IncognitonWindows64Browser">Download</a></td><td><a href="https://www.incogniton.com/146IncognitonWindows32Browser">Download</a></td><td><a href="https://www.incogniton.com/146IncognitonMacBrowser">Download</a></td><td><a href="https://www.incogniton.com/146IncognitonMacBrowserArm">Download</a></td></tr><tr><td>143</td><td>1.0.0.1</td><td><a href="https://www.incogniton.com/143IncognitonWindows64Browser">Download</a></td><td><a href="https://www.incogniton.com/143IncognitonWindows32Browser">Download</a></td><td><a href="https://www.incogniton.com/143IncognitonMacBrowser">Download</a></td><td><a href="https://www.incogniton.com/143IncognitonMacBrowserArm">Download</a></td></tr><tr><td>141</td><td>1.0.0.5</td><td><a href="https://www.incogniton.com/141IncognitonWindows64Browser">Download</a></td><td><a href="https://www.incogniton.com/141IncognitonWindows32Browser">Download</a></td><td><a href="https://www.incogniton.com/141IncognitonMacBrowser">Download</a></td><td><a href="https://www.incogniton.com/141IncognitonMacBrowserArm">Download</a></td></tr><tr><td>139</td><td>1.1.0.2</td><td><a href="https://www.incogniton.com/139IncognitonWindows64Browser">Download</a></td><td><a href="https://www.incogniton.com/139IncognitonWindows32Browser">Download</a></td><td><a href="https://www.incogniton.com/139IncognitonMacBrowser">Download</a></td><td>—</td></tr><tr><td>137</td><td>1.0.0.3</td><td><a href="https://www.incogniton.com/137IncognitonWindows64Browser">Download</a></td><td><a href="https://www.incogniton.com/137IncognitonWindows32Browser">Download</a></td><td><a href="https://www.incogniton.com/137IncognitonMacBrowser">Download</a></td><td>—</td></tr><tr><td>134</td><td>1.2.0.0</td><td><a href="https://www.incogniton.com/134IncognitonWindows64Browser">Download</a></td><td><a href="https://www.incogniton.com/134IncognitonWindows32Browser">Download</a></td><td><a href="https://www.incogniton.com/134IncognitonMacBrowser">Download</a></td><td>—</td></tr><tr><td>131</td><td>1.1.0.2</td><td><a href="https://www.incogniton.com/131IncognitonWindows64Browser">Download</a></td><td><a href="https://www.incogniton.com/131IncognitonWindows32Browser">Download</a></td><td><a href="https://www.incogniton.com/131IncognitonMacBrowser">Download</a></td><td>—</td></tr><tr><td>129</td><td>1.0.0.2</td><td><a href="https://www.incogniton.com/129IncognitonWindows64Browser">Download</a></td><td><a href="https://www.incogniton.com/129IncognitonWindows32Browser">Download</a></td><td><a href="https://www.incogniton.com/129IncognitonMacBrowser">Download</a></td><td>—</td></tr></tbody></table>

{% hint style="info" %}
Not sure which Mac chip you have? Click the Apple menu > **About this Mac**. If the Chip field shows Apple M1 or later, choose ARM; if it shows Intel, choose Intel.
{% endhint %}

#### Windows OS

{% stepper %}
{% step %}
**Open the data directory**

Click **Settings** in the left sidebar and select the **Debug tools** tab. Under **Data**, click **Open data directory**, then navigate to `Browser > [your version number] > Win` inside the folder that opens.

Full path:

```
C:\Users\USERNAME\AppData\Roaming\Incogniton\Incogniton\browser\[version]\win
```

{% endstep %}

{% step %}
**Download the browser**

Use the table above to find the download link for your version, then select either the 64-bit or 32-bit file. If you're not sure which applies to your system, 64-bit is correct for most Windows machines. The file downloads as a ZIP named **Update**.
{% endstep %}

{% step %}
**Install the browser files**

Unzip the downloaded file and copy its contents into the Win folder from Step 1. Then check whether `VERSION.txt` exists in that folder. If it doesn't, you'll need to create it:

1. Open a text editor and create a new file.
2. Type the VERSION.txt value for your version from the table above.
3. Save the file as `VERSION.txt` in that same folder.
   {% endstep %}

{% step %}
**Test the installation**

Run the `chrome` file inside the folder. If the browser opens successfully, the installation is complete and you can delete the **Update** folder.
{% endstep %}
{% endstepper %}

#### MacOS

{% stepper %}
{% step %}
**Open the data directory**

Click **Settings** in the left sidebar and select the **Debug tools** tab. Under **Data**, click **Open data directory**, then navigate to `Browser > [your version number] > Mac` inside the folder that opens.

Full path:

```
/Users/USERNAME/Library/Application Support/Incogniton/browser/[version]/mac
```

If you can't find the Library folder? Follow this guide: [How to open the Library folder on Mac ↗](https://www.macinstruct.com/tutorials/how-to-open-the-library-folder-on-your-mac/).
{% endstep %}

{% step %}
**Download the browser**

Use the table above to find the download link for your version, choosing **ARM** if your Mac has an Apple Silicon chip (M1 or later) or **Intel** for older Macs. The file downloads as a ZIP named **Update**.

{% hint style="info" %}
ARM builds aren't available for versions 137 and earlier, so use the single Mac download link if you're on one of those versions.
{% endhint %}
{% endstep %}

{% step %}
**Install the browser files**

Unzip the downloaded file and copy its contents into the Mac folder from Step 1. Then check whether `VERSION.txt` exists in that folder. If it doesn't, you'll need to create it:

1. Open a text editor and create a new file.
2. Type the VERSION.txt value for your version from the table above.
3. Save the file as `VERSION.txt` in that same folder.
   {% endstep %}

{% step %}
**Test the installation**

Run the `chrome` file inside the folder. If the browser opens successfully, the installation is complete and you can delete the **Update** folder.
{% endstep %}
{% endstepper %}

### Confirm your profile browser version

Once the installation is complete, take a moment to confirm that your profiles are set to the version you just installed. Click the three-dot icon on the profile and select **Edit**. The browser version shown should match the one you just installed.

{% hint style="info" %}
Still having trouble? Contact our [support team](https://incogniton.com/contact/).
{% endhint %}
