Skip to main content
Connecting GitHub lets CodeCobra push custom module code directly to your repositories, create pull requests, and manage branch-based deployments. This is how your customizations move from CodeCobra to your actual Odoo environment.

​
Connect your GitHub account

1

Go to settings

Navigate to Settings > GitHub.
2

Authorize CodeCobra

Click Connect GitHub and follow the prompts to authorize the CodeCobra GitHub app on your account. You’ll be redirected to GitHub where you can review the permissions being requested.
3

Select repositories

Choose which repositories CodeCobra can access. You can grant access to all repositories or select specific ones. You can always change this later from your GitHub app settings.
Workspaces can have their own GitHub connection, separate from individual user accounts. This is useful when the workspace owns the repositories rather than any individual member. Workspace owners can connect GitHub from the workspace settings.

​
Add repositories to a project

Once GitHub is connected, you can link repositories to any project:
1

Open project settings

Open a project and go to the Settings tab.
2

Add a repository

Click Add Repository and search for the repository you want to connect.
3

Configure branches

For each repository, select:
  • Staging branch — where code goes for testing (e.g., staging or develop)
  • Production branch — where final, approved code is deployed (e.g., main or production)
You can connect multiple repositories to a single project. This is common when your Odoo setup uses separate repos for different module groups (e.g., one repo for custom modules and another for third-party customizations).

​
How branches work

CodeCobra uses a branching workflow to keep your code safe and organized: The workflow is:
  1. CodeCobra creates a feature branch for each task
  2. When you’re ready to test, you merge to staging from the task’s Branch Manager
  3. After testing on staging, you merge to production to go live
Your production code is never modified until you explicitly approve and merge it. This gives you full control over what gets deployed and when.
If your team uses a review process, the staging merge is a natural checkpoint. Deploy staging to a test environment, have your team review the changes, and only merge to production when everyone is satisfied.

​
Disconnect GitHub

To remove the GitHub connection:
  1. Go to Settings > GitHub
  2. Click Disconnect
This removes CodeCobra’s ability to push code or create pull requests. It does not delete any code that has already been pushed to your repositories.
Disconnecting GitHub prevents CodeCobra from deploying code for all projects that use your GitHub connection. Existing tasks in development will not be able to merge until you reconnect. Consider the impact before disconnecting.

​
Common questions

Can I connect the same repository to multiple projects? Yes. If you have one repository that serves multiple Odoo instances, you can connect it to each corresponding project with different branch configurations. What happens if I add a new repository to an existing project? Existing tasks won’t be affected. New tasks will include the new repository in their branch manager. If you need an existing task to work with a newly added repo, create a follow-up task. Do I need GitHub to use CodeCobra? No. You can use CodeCobra without GitHub — you’ll still be able to explore Odoo features, create development plans, build modules, and preview changes. You just won’t be able to merge code through the Branch Manager. Instead, you can download your customizations as a ZIP file and deploy manually.