> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getcollate.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Query Runner Application for SQL Studio

> Install the Query Runner application to enable SQL Studio - execute SQL queries directly against database services from within Collate.

# Query Runner Application

The Query Runner application enables SQL Studio functionality in Collate, allowing users to execute SQL queries directly against configured database services from within the platform. This eliminates the need to switch between different database clients and provides a unified query execution experience.

## Overview

Query Runner powers SQL Studio, Collate's integrated query execution environment. Once installed and configured, users can:

* **Unified Query Interface**: Write, Save & Execute SELECT queries to explore data across multiple database services without switching tools
* **Flexible Authentication**: Support for SSO-based, OAuth, and credential-based authentication methods

## Prerequisites

* **Admin Access**: You must have administrator privileges in Collate

## Installation

To install the Query Runner application, follow these steps:

1. Select the **Profile** icon and navigate to **Settings** > **Applications**.

2. Click **Add Apps** and select the **Query Runner** application.

   <img src="https://mintcdn.com/collatedocs/bKBGXz6FBahnppp1/public/images/ai-2.0/admin-guide/applications/select-query-runner.png?fit=max&auto=format&n=bKBGXz6FBahnppp1&q=85&s=e657e43888cfe8e1152f35fd30bd6da1" alt="Select Query Runner Application" width="2894" height="1174" data-path="public/images/ai-2.0/admin-guide/applications/select-query-runner.png" />

3. Click **Install**.

4. Set a schedule for the application and click **Submit**.

The Query Runner application appears in your **Installed Applications** list and show status as **Active**

<Tip>
  **Tip**: Installation typically takes a few seconds. If the run fails, check the application logs in **Settings** > **Applications** > **Query Runner** > **Logs**.
</Tip>

## Post-Installation

After tnstallation, **SQL Studio** appears in the main navigation menu.

<Tip>
  **Tip**:
  **Next Steps**: After installation, administrators must configure SQL Studio for supported database services. For detailed setup instructions, see the [SQL Studio Admin Configuration](/ai-2-0/how-to-guides/sql-studio/admin-configuration).
</Tip>

## View Logs

To troubleshoot the issues, you can view the application logs:

1. Go to **Settings** > **Applications** > **Query Runner**.
2. Select the **Logs** tab.
3. Review recent logs for errors or warnings.
4. Filter logs by date or severity level.

## Uninstall Querry Runner App

If you need to remove SQL Studio:

1. Go to **Settings** > **Applications** > **Query Runner**.
2. Select the **⋮** icon and click **Uninstall**.
3. Click **Ok** to remove the appication.

## Troubleshooting

### Installation Fails

**Problem**: Installation fails with "Application cannot be installed"

**Solutions**:

* Verify you have admin privileges
* Check that your Collate instance meets minimum requirements
* Review application logs for specific error messages
* Contact support if the issue persists

### Application Not Appearing

**Problem**: After installation, SQL Studio doesn't appear in the navigation

**Solutions**:

* Refresh your browser (Cmd/Ctrl + R)
* Clear browser cache and cookies
* Log out and log back in
* Verify the application status is "Active" in **Settings** > **Applications**

## Next Steps

After installing the Query Runner application, follow the **[SQL Studio](/ai-2-0/how-to-guides/sql-studio)**  to get started.