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

# Garth admin setup

> Install the GAssist app in your Slack workspace. A one-time setup performed by a Garth admin.

Before members can use GAssist in Slack, a Garth admin installs the GAssist app into your organization's Slack workspace. This links your Slack workspace to your Garth tenant and authorizes GAssist to post pull request activity and respond to commands.

<Info>
  This setup is required only once per Slack workspace. After you complete it, any member of the workspace can start using GAssist and link their Git account.
</Info>

## Before you start

* You need Garth admin access to [app.heygarth.ai](https://app.heygarth.ai/).
* You need permission to install apps in your Slack workspace. If your workspace restricts app installs, a Slack Workspace Owner or Admin may need to approve the request.

## Install GAssist in Slack

<Steps>
  <Step title="Sign in to Garth">
    Sign in to [app.heygarth.ai](https://app.heygarth.ai/) with your Garth admin account.
  </Step>

  <Step title="Open the Integrations settings">
    Go to [Settings > Integrations](https://app.heygarth.ai/settings/integrations).
  </Step>

  <Step title="Install GAssist App on Slack">
    In the **Slack** section, select **Install GAssist App on Slack**.

    <img src="https://mintcdn.com/na-f445b234/9wEJgWqAY-RDCkJH/images/gassist/slack-admin-install.png?fit=max&auto=format&n=9wEJgWqAY-RDCkJH&q=85&s=8566a5a59b16e51589064eaa75954bb5" alt="Slack section on the Garth integrations page with the Install GAssist App on Slack button" width="535" height="241" data-path="images/gassist/slack-admin-install.png" />
  </Step>

  <Step title="Allow access in Slack">
    Slack opens an authorization screen listing the permissions GAssist needs. Confirm the workspace, review the permissions, and select **Allow** to complete the installation.

    <img src="https://mintcdn.com/na-f445b234/9wEJgWqAY-RDCkJH/images/gassist/slack-admin-authorize.png?fit=max&auto=format&n=9wEJgWqAY-RDCkJH&q=85&s=128d8dc89755f14454f2b2c37083b2fe" alt="Slack authorization screen to allow the GAssist app to access the workspace, with the Allow button" width="858" height="638" data-path="images/gassist/slack-admin-authorize.png" />
  </Step>
</Steps>

Once installed, GAssist posts a **Welcome to GAssist** card confirming the app is connected. Your Slack workspace is now linked to your Garth tenant, and members can start using GAssist.

<img src="https://mintcdn.com/na-f445b234/9wEJgWqAY-RDCkJH/images/gassist/slack-welcome.png?fit=max&auto=format&n=9wEJgWqAY-RDCkJH&q=85&s=102f7210806aa6c22ac7638ed5e62a4b" alt="Welcome to GAssist card in Slack showing capabilities and the pre-setup checklist" width="721" height="602" data-path="images/gassist/slack-welcome.png" />

## Next step

Share the [Overview](/gassist/slack/getting-started) with your team so members can open GAssist and link their Git account.