> For the complete documentation index, see [llms.txt](https://docs.madconnect.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.madconnect.ai/deployment-options/snowflake-native-application/installation-guide.md).

# Installation Guide

### Installation (Snowflake Marketplace)

1. **Search**: 
   * In the **Snowflake Marketplace**, search for *MadConnect*.
2. **Request**: 
   * Click **Request** to initiate access (MadConnect approves the listing share).
3. **Install**: 
   * After approval, go to **Data Products → Apps → Get**. Select a default warehouse and confirm details.
4. **Verify**: 
   * Confirm it appears under **Installed Apps** (and under **Private Sharing** → **Shared with You**). A confirmation email may be sent by Snowflake.<br>

<figure><img src="/files/iKrula2UyFZ7MZ73T1iu" alt=""><figcaption></figcaption></figure>

***

### Setup Wizard (v1.55+)

{% hint style="info" %}
Important: Use Setup\_Guide (left navigation) to configure the application. Do not use the top‑right Launch App button; that opens a Snowflake worksheet.
{% endhint %}

<figure><img src="/files/oq2hkq6hSH1En1IcqlSp" alt=""><figcaption></figcaption></figure>

#### Step‑by‑step

1. **Prerequisites Check:**
   * Click **Mark Prerequisites as Reviewed.**

<figure><img src="/files/NfyWk1I3TPgef6xo8C0M" alt=""><figcaption></figcaption></figure>

2. **Compute Pool Setup:**
   * Optionally update compute pool names.
   * Copy the generated SQL, run it in a Snowflake **Worksheet**.
   * Click **Validate Compute Pool Setup**.<br>

<figure><img src="/files/6ogKiV0pQSSVzvOSYYSq" alt=""><figcaption></figcaption></figure>

3. **Warehouse Setup:**
   * If using an **existing** warehouse: **Copy Grant Warehouse Commands** and run in Snowflake worksheet.
   * If **creating** a new one: complete the form, **Copy Create and Grant Warehouse Commands** in your Worksheet, run it.
   * Click **Validate** Warehouse Setup.<br>

<figure><img src="/files/LPQlEB9UTVV3n7rCbKJv" alt=""><figcaption></figcaption></figure>

4. **User & Role Configuration:**
   1. Update **User Name** and **Role Name** if desired.
   2. Click **Store User & Role Configuration**.<br>

<figure><img src="/files/I1DeshtHFSa5IPUM7ayR" alt=""><figcaption></figcaption></figure>

5. **Service Deployment:**
   1. Copy the **Service Deployment** command, run in **Worksheet**.
   2. Click **Validate Service Deployment**.<br>

<figure><img src="/files/J2ykgNjddfUTAm39XNgi" alt=""><figcaption></figcaption></figure>

6. **Final Validation:**
   * Click **Run Complete Validation**.<br>

<figure><img src="/files/hO1JtJsyWFuoRfDum7At" alt=""><figcaption></figcaption></figure>

7. **Launch** **Application**:
   * If you changed defaults in above steps, choose **Alter Service → Get Application URL**.
   * Share the URL internally; users will access MadConnect via this link and will be prompted to sign in with Snowflake credentials.

<figure><img src="/files/0zAb4i9xKlFOIPEeapEX" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/28iVmBqz8lZhEmjecNPI" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/PRRQRxazccQdtvq4H1Nn" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Testing tip: Recreate connections in MadConnect after service alterations to avoid issues from previous configurations.<br>
{% endhint %}