All articles
Getting Started
What is CICDoo Getting started: the onboarding wizard The Dashboard and Infrastructure MapConcepts
Production, staging and development stages Domains, subdomains and SSL Odoo versions and editions (Community vs Enterprise) Workspaces and team collaborationServers
Adding a server Server domains and DNS Using a load balancer Server actions: deploy, logs and chartsProjects & Git
Creating a project Connecting GitHub Connecting GitLab Branches and instancesInstances & 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 queueAgent Tasks
What agent tasks are Setting up agent tasks Running a task and reviewing the result Agent time and top-upsMonitoring & 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 resourceAccount & Security
Two-factor authentication (2FA) Profile and integrations settings Passwords and account recoveryBilling & Plans
Plans and pricing Upgrading and managing your subscription If a project subscription goes unpaid The channel partner programSupport & Tickets
Opening a support ticket Getting help from the CICDoo teamTroubleshooting
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 problemsProjects & 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
- Open Settings, then the Integrations tab.
- 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.
- 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.
Still stuck? Open a ticket from the app or talk to an engineer.