All articles

Getting Started

What is CICDoo Getting started: the onboarding wizard The Dashboard and Infrastructure Map

Concepts

Production, staging and development stages Domains, subdomains and SSL Odoo versions and editions (Community vs Enterprise) Workspaces and team collaboration

Servers

Adding a server Server domains and DNS Using a load balancer Server actions: deploy, logs and charts

Projects & Git

Creating a project Connecting GitHub Connecting GitLab Branches and instances

Instances & Console

Creating an instance Restarting, stopping and removing an instance Merging branches between stages Web IDE and remote access Instance settings explained Deployments and the job queue

Agent Tasks

What agent tasks are Setting up agent tasks Running a task and reviewing the result Agent time and top-ups

Monitoring & Backups

Monitoring your instance Backups and restore Alert notifications (email and SMS)

Workspaces & Permissions

Inviting workspace members Member permissions and resource access A member cannot see or use a resource

Account & Security

Two-factor authentication (2FA) Profile and integrations settings Passwords and account recovery

Billing & Plans

Plans and pricing Upgrading and managing your subscription If a project subscription goes unpaid The channel partner program

Support & Tickets

Opening a support ticket Getting help from the CICDoo team

Troubleshooting

Troubleshooting: cannot connect a server Troubleshooting: a deployment failed Troubleshooting: git push fails with 403 after moving a repository Troubleshooting: my instance is down or slow Troubleshooting: domain or SSL problems

Projects & Git

Connecting GitHub

How to connect your GitHub account to CICDoo via OAuth or a personal access token, and where to manage or disconnect it.

Two ways to connect

CICDoo needs access to your GitHub account to create repositories and deploy projects. You can connect in either of two ways:

  • OAuth: click "Connect with GitHub OAuth" (or "Connect with GitHub" inside the New Project modal). You are sent to GitHub to approve the connection and then returned to CICDoo.
  • Personal Access Token (PAT): click "configure a Personal Access Token", paste a token and save it. The UI links to GitHub's token creation page and notes the required scopes: repo and read:user.

Once connected, CICDoo shows a green "GitHub Connected" panel with your GitHub username.

Where to manage the connection

  • Settings, Integrations tab: the GitHub Integration card shows your connection status, the OAuth and PAT options, and a Disconnect button.
  • New Project modal: when you pick GitHub as the provider, the same connect options appear inline so you can connect without leaving the project flow.

Enterprise edition and PATs

If you deploy Odoo Enterprise, OAuth alone is not enough. The Integrations tab and the New Project modal both show an "Enterprise Edition Requires PAT" notice: Odoo Enterprise repositories are private, so you must configure a GitHub Personal Access Token whose account has access to the Odoo Enterprise repos. The panel also shows your current PAT status.

If you move or rename the repository

If you transfer the repository to an organization or rename it on GitHub, fetches keep working but pushes start failing with a 403. Open the project's Settings, go to the GitHub tab, and click Re-sync from GitHub to repoint it, then restart your instances. See Troubleshooting: git push fails with 403 after moving a repository.

Disconnecting

Open Settings, then the Integrations tab, and click Disconnect on the GitHub card (the same button appears in the New Project modal when connected). After disconnecting you can reconnect at any time with OAuth or a new PAT.

Quick steps

  1. Open Settings, then the Integrations tab.
  2. On the GitHub Integration card, click "Connect with GitHub OAuth", or choose "configure a Personal Access Token" and save a token with repo and read:user scopes.
  3. Confirm the card shows "GitHub Connected".

If you get stuck, open a support ticket from the Tickets page or the chat widget.

Previous Creating a project Next Connecting GitLab

Still stuck? Open a ticket from the app or talk to an engineer.