Skip to main content
GitHub Integration

Organizations can connect their One Codex accounts directly to their GitHub repositories, to make it easier to run your Workflows

Denise Lynch avatar
Written by Denise Lynch
Updated over a week ago

Setting up your own Workflows on One Codex is made easier when you can connect directly to your GitHub repositories. We now support connecting your GitHub account with your One Codex account.

How to Connect

As an organization owner or admin, you can integrate One Codex with GitHub from your settings page (click your name at the top-right of the One Codex site, and choose Settings). Towards the bottom of your settings page, you'll see a section for GitHub Integration.

There are two ways to connect your One Codex account to GitHub; either via our GitHub App, or via a GitHub Personal Access Token.

One Codex GitHub App

One Codex has developed a GitHub app, which an organization owner or admin can install on behalf of all organization members. If installed, the GitHub app takes precedence over individual Personal Access Tokens. Clicking "Install One Codex GitHub App" takes you to GitHub. Once logged in, you can choose which GitHub organization(s) you wish to install the app for. Once you've selected you organization, you will be able to choose whether to provide access to all repositories, or only selected repositories.

Note: You will need to be a GitHub Organization Owner in order to be able to provide access to the repositories.

GitHub Personal Access Token

If you don't want to connect GitHub for all members in your One Codex organization, you can instead choose to connect via your own Personal Access Token. Note that if the GitHub integration app is enabled, you will not be able to provide a Personal Access Token, as the app integration takes precedence.

To generate a Personal Access Token, you will need to follow these GitHub steps.

Using your GitHub Integration

Integrating your GitHub account with your One Codex account allows you to access your GitHub repositories for your Workflows.

Disconnecting From GitHub

If you have connected via the GitHub app, returning to your settings page, you will see a button to remove the GitHub App integration. Note that this does not uninstall the app from GitHub. You can uninstall from GitHub by visiting your GitHub installations page.

If you have provided a GitHub Personal Access Token, you will see an option to either Update or Remove your Personal Access Token from your One Codex settings page. You can also delete your Personal Access Token within GitHub by following these steps.

Did this answer your question?