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

# Discourse

> Access knowledge from your Discourse **Topics**

## How it works

The Discourse connector indexes documents from your Discourse **Topics**.

## Setting up

### Authorization

<Steps>
  <Step title="Log in to Discourse">
    Log into your Discourse account

    <Info>
      This Discourse user must have admin privileges
    </Info>
  </Step>

  <Step title="Open API keys">
    Click the **Admin** menu from the home page. Open the **Advanced** sub-menu and select **API keys**.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/i9pIrvFbh53KkrjR/assets/admins/connectors/discourse/discourse_1.gif?s=e422d10ae8aa823fd5f9ed3ac5b69777" alt="Discourse admin navigation to the API keys page" width="1002" height="1388" data-path="assets/admins/connectors/discourse/discourse_1.gif" />
  </Step>

  <Step title="Create API key">
    Click **New API Key**, name it "Gorbit". Select "All Users" for **User Level** and "Read-only" for **Scope**.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/i9pIrvFbh53KkrjR/assets/admins/connectors/discourse/discourse_2.gif?s=80c72eb8d91087924d32fdcc2eda5c24" alt="Create and fill out API key" width="2146" height="1388" data-path="assets/admins/connectors/discourse/discourse_2.gif" />
  </Step>

  <Step title="Save and copy key">
    Click **Save**. Copy the key and put it into Gorbit.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/i9pIrvFbh53KkrjR/assets/admins/connectors/discourse/discourse_3.gif?s=edcf075680818955d2f11b6c0885699e" alt="Create and copy API key" width="2560" height="1192" data-path="assets/admins/connectors/discourse/discourse_3.gif" />
  </Step>

  <Step title="Set API key username">
    For the API Key Username,
    enter the username of the Discourse account which has access to the information you'd like to index.
  </Step>
</Steps>

### Indexing

<Steps>
  <Step title="Name the connector">
    Input a name for a connector (if you plan on creating multiple Discourse connectors,
    this will be used by you to tell between them)
  </Step>

  <Step title="Provide base URL">
    Provide your Discourse's base url.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/i9pIrvFbh53KkrjR/assets/admins/connectors/discourse/discourse_4.gif?s=690e17d984008b9be9153e9349a0f67e" alt="Fill out Gorbit connector" width="2560" height="1274" data-path="assets/admins/connectors/discourse/discourse_4.gif" />
  </Step>

  <Step title="Enter Topics to index">
    Enter the **Topics** you wish to index. If left blank, all topics available will be indexed.
  </Step>

  <Step title="Start indexing">
    Click connector to begin indexing the indicated **topics**.
  </Step>
</Steps>