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

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: Free, Pro and Enterprise" Upgrading and managing your subscription What happens when you hit a plan limit

Support & Tickets

Opening a support ticket Getting help from the CICDoo team

Troubleshooting

"Troubleshooting: cannot connect a server" "Troubleshooting: a deployment failed" "Troubleshooting: my instance is down or slow" "Troubleshooting: domain or SSL problems"

Projects & Git

Connecting GitLab

How to connect a GitLab account (gitlab.com or self-hosted) to CICDoo via OAuth or a personal access token.

Two ways to connect

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

  • OAuth: click "Connect with GitLab OAuth" (or "Connect with GitLab" inside the New Project modal). You are sent to GitLab to approve the connection and then returned to CICDoo.
  • Personal Access Token (PAT): click "configure a Personal Access Token". The form has two fields:
  • GitLab URL: defaults to https://gitlab.com. If you run a self-hosted GitLab, enter your instance's URL here.
  • GitLab Personal Access Token: paste your token. The UI links to GitLab's token page and notes the required scopes: api and read_user.

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

Self-hosted GitLab

Use the PAT method with the GitLab URL field when your repositories live on a self-hosted GitLab instance rather than gitlab.com. Enter the base URL of your instance and a token created there.

Where to manage the connection

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

Disconnecting

Open Settings, then the Integrations tab, and click Disconnect on the GitLab card (the same option appears in the New Project modal when connected). You can reconnect later with OAuth or a new PAT.

Quick steps

  1. Open Settings, then the Integrations tab.
  2. On the GitLab Integration card, click "Connect with GitLab OAuth", or choose "configure a Personal Access Token", set the GitLab URL if self-hosted, and save a token with api and read_user scopes.
  3. Confirm the card shows "GitLab Connected".

For using the connection to create or import a project, see Creating a project.

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

Previous Connecting GitHub Next Branches and instances

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