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 Deleting a server

Projects & Git

Creating a project Connecting GitHub Project GitHub settings and webhook Connecting GitLab Branches and instances Tagging and filtering projects High availability with app nodes Project environments, extensions and deletion

Instances & Console

Creating an instance Restarting, stopping and removing an instance Merging branches between stages Web IDE and remote access SSH access to instances 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 Agent insights and task filters

Monitoring & Backups

Monitoring your instance Backups and restore S3 storage, uploads and bulk backup actions Alert notifications (email and SMS)

Workspaces & Permissions

Inviting workspace members Member permissions and resource access A member cannot see or use a resource Audit log and server activity

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 Onboarding a client as a partner

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 GitLab

How to connect a GitLab account (gitlab.com or self-hosted) to CICDoo with OAuth or a personal access token, and how to disconnect it.

CICDoo needs access to your GitLab account to create repositories, import existing ones and deploy them. You can connect in two ways:

  • OAuth: you approve CICDoo on GitLab and are sent back.
  • Personal Access Token (PAT): you create a token with the api and read_user scopes and paste it into CICDoo, together with your GitLab URL. Use this for a self-hosted GitLab.

You manage the connection in Settings, on the "Integrations" tab, in the "GitLab Integration" card. The same options appear inside the "Create New Project" wizard when you pick GitLab, so you can connect without leaving it.

Connecting with OAuth

  1. Open Settings and go to the "Integrations" tab.
  2. In the "GitLab Integration" card, click "Connect with GitLab OAuth" (in the project wizard the button is "Connect with GitLab").
  3. Approve the request on GitLab.
  4. Back in CICDoo, check that the card shows "GitLab Connected" with your GitLab username.

Connecting with a personal access token

  1. In GitLab, create a personal access token with the api and read_user scopes. The "GitLab Settings" link under the token field opens the token page on gitlab.com.
  2. In CICDoo, open Settings, go to the "Integrations" tab and, in the "GitLab Integration" card, click "configure a Personal Access Token".
  3. In "GitLab URL", keep https://gitlab.com, or enter the address of your self-hosted GitLab.
  4. Paste the token into "GitLab Personal Access Token" (in the project wizard the field is called "Personal Access Token").
  5. Click "Save PAT".
  6. Check that the card shows "GitLab Connected".

Self-hosted GitLab

If your repositories live on your own GitLab server, use the personal access token method. Enter the base address of your GitLab in "GitLab URL" and create the token on that server, not on gitlab.com.

Enterprise edition on a GitLab project

The Odoo Enterprise source code is hosted on GitHub in private repositories. If a GitLab project uses Enterprise, a GitHub classic token with access to those repositories is still needed. See Connecting GitHub and Odoo versions and editions (Community vs Enterprise).

Disconnecting GitLab

  1. Open Settings and go to the "Integrations" tab.
  2. In the "GitLab Integration" card, click "Disconnect".
  3. Confirm "Disconnect your GitLab account?".

You can reconnect later with OAuth or a new token. The same "Disconnect" option also appears in the project wizard when GitLab is connected.

Related: Creating a project, Connecting GitHub, Profile and integrations settings.

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

Previous Project GitHub settings and webhook Next Branches and instances

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