Skip to main content

How it works

The Discourse connector indexes documents from your Discourse Topics.

Setting up

Authorization

1

Log in to Discourse

Log into your Discourse account
This Discourse user must have admin privileges
2

Open API keys

Click the Admin menu from the home page. Open the Advanced sub-menu and select API keys.
3

Create API key

Click New API Key, name it “Onyx”. Select “All Users” for User Level and “Read-only” for Scope.
4

Save and copy key

Click Save. Copy the key and put it into Onyx.
5

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.

Indexing

1

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)
2

Provide base URL

Provide your Discourse’s base url.
3

Enter Topics to index

Enter the Topics you wish to index. If left blank, all topics available will be indexed.
4

Start indexing

Click connector to begin indexing the indicated topics.