# Monolith Desktop Setup

## Initial Installation

To download Monolith Desktop, go to the [System section](/monolith/monolith-features/settings/system.md#desktop-installers) of the settings page and download the appropriate installer for you operating system (Windows or MacOS)

After installing Monolith Desktop and running it for the first time, you will be presented with an "API Mode" selection screen.

This screen allows you to connect Monolith Desktop to your Monolith Tenant, whether it is in the Cloud or On-premises:

<figure><img src="/files/0dDRYVP94vmNBPkwqEBg" alt=""><figcaption><p>Monolith Desktop - API Mode Selection</p></figcaption></figure>

### Cloud Customers

For cloud hosted Monolith Tenants/Customers - keep the default selection as "Cloud".  The region is defaulted to US/North America, but if you are a UK customer, change the region to "United Kingdom" and select submit.

This option ensures that Monolith Desktop will connect to the correct Monolith Server for your cloud deployment or region.

{% hint style="info" %}
Additional Cloud regions may be added in the future.
{% endhint %}

### On-Premises Customers

For on premises customers - change the "API Mode" to "On-Premises".  This mode allows Monolith to connect to an on-premises Monolith server that is running within your organization and network.

When you select the On-Premises option, you then need to enter your Monolith Server's API endpoint.  This will typically be the IP address of your Monolith server, or a custom domain if you have one setup in your network.

The API endpoint must meet the following formats:

```
https://{monolith-server-ip-address}/api
```

```
https://{custom-monolith-domain}/api
```

```
Examples:
https://192.168.1.22/api
https://monolith.myorg.com/api
```

If Monolith Desktop can successfully reach the Monolith server, you will see a green check mark populate and the Monolith Login screen will load.

<figure><img src="/files/VWSLqz0pkjSCdZeK5wor" alt=""><figcaption><p>Monolith On-Premises Server Connection</p></figcaption></figure>

### Reset Monolith Connection Settings

To reset Monolith's API connection settings, click the "Reset Monolith" button located on the Monolith Login screen.  This will return you to the API mode selection.

<figure><img src="/files/FwyBB73TVOZEbhu49V97" alt=""><figcaption><p>Monolith Login Page</p></figcaption></figure>


---

# Agent Instructions: 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:

```
GET https://docs.monolithforensics.com/monolith/monolith-features/getting-started/monolith-desktop-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.