Custom Connectors

Not every data source lives in the Erathos catalog. If you have your own API, an internal tool, or another in-house data source, you can point Erathos at a GitHub repository containing your own connec

How it works

1. Install the Erathos GitHub App on the account or organization that owns your connector's code.

2. Tell Erathos which repository to build from.

3. Every push to the watched repository rebuilds its connector image.

4. Use it like any other connector. Once the first build succeeds, your connector appears in the datasource catalog with a Custom badge, and you set up a connection the same way you would for any built-in connector.

Prerequisites

• Admin access on the GitHub account or organization that owns the repository you want to watch.

• A repository containing a valid Erathos connector project (See the development guide)

Connect GitHub to your workspace

1. Go to Connections → New Connection → Select datasource, or Settings → Workspace → Repositories.

2. Click Connect a custom connector via GitHub.

3. You're sent to GitHub to install the Erathos GitHub App. Choose the account or organization, then select the repositories you want to give Erathos access to.

4. GitHub redirects you back to Erathos automatically, landing on the datasource screen with the Watch repository dialog already open.

If the installation fails or is cancelled, Erathos shows a short message linking back to this page.

Watch a repository

1. Open Settings → Workspace → Repositories and click Add repository (or use the Custom connector via GitHub tile on the datasource screen).

2. Enter the repository in owner/repo format, e.g. your-org/your-connector.

3. Click Watch repository.

Erathos needs to already have access to that repository through your GitHub App installation. If it doesn't, you'll see:

Could not access this repository with the connected GitHub App installation.

To fix this, open your GitHub App installation settings on GitHub, grant it access to the repository, and try again.

Once a repository is watched, Erathos triggers the first build. This can take a few minutes — the Repositories page refreshes automatically until it completes.

Managing watched repositories

Go to Settings → Workspace → Repositories to see everything currently watched, including the repository name and branch.

Click Remove next to a repository to stop watching it. This immediately stops it from syncing — its connector will no longer rebuild on new pushes. Confirm the removal in the dialog; this cannot be undone from this page.

Using your custom connector

Once the first build succeeds, the connector built from your repository appears in Connections → New Connection → Select datasource, marked with a Custom badge. Click it, give the connection a name, and continue setup exactly as you would for any other connector.