Skip to main content
This tutorial gets you from a fresh install of Coral, to your first SQL query.
Prefer the CLI experience? Run coral onboard for an interactive wizard that walks you through the whole setup described in this page.

​
1. Discover bundled sources

coral source discover
This lists the bundled sources available in your build. Coral comes with bundled sources for GitHub, Slack, Datadog, Linear, Sentry, and more.

​
2. Add a source

For example, add GitHub. Pass --interactive and Coral will prompt you for each required input: 
coral source add --interactive github
Once connected, the source’s data is available as SQL tables. To update a source’s credentials later, run the same command again.
For scripted setups, omit --interactive and Coral reads each input from an environment variable of the same name — e.g. GITHUB_TOKEN=ghp_... coral source add github.

​
3. Query your data

You can now query any connected source using SQL. Use coral.tables to see all available tables: 
coral sql "SELECT schema_name, table_name FROM coral.tables ORDER BY 1, 2"
Assuming you’ve connected GitHub, try listing open issues for a repo: 
coral sql "
  SELECT number, title, state, created_at
  FROM github.issues
  WHERE owner = 'withcoral' AND repo = 'coral' AND state = 'open'
  ORDER BY created_at DESC
  LIMIT 10
"

​
Next steps