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

Branches and instances

How Git branches map to instances in the project console, how to create instances, and where to follow commits and deployments.

Branches become instances

In CICDoo, each instance of your project runs one Git branch. When you open a project, the console sidebar lists your instances grouped by stage:

  • Production
  • Staging
  • Development

Each entry is named after its branch. Click one to open that instance's console.

Creating an instance from a branch

Next to the Staging and Development headings in the sidebar there is a plus button (shown when you have permission to create instances). Clicking it opens the Create Instance modal:

  • Branch Name: the name of the new branch, for example feature-xyz.
  • Fork From: the base branch to create the new branch from, prefilled with the project's default branch (for example main or 18.0).
  • Stage: shows the stage you clicked (Staging or Development).

Click Create. CICDoo creates the branch and the instance, and it appears in the sidebar under its stage.

The instance console

At the top of an instance's console you see the branch name, a stage badge, the instance's domain and an Open Instance link, plus action buttons such as Restart and Merge (depending on your permissions). Below that, tabs give access to different areas, including:

  • Commits: a Recent Commits list for the instance's branch, with a Refresh button.
  • Queue: the list of jobs for this instance, with a Refresh button.
  • Other tabs such as Access, Logs, Monitoring, Backups (production and staging) and Settings, depending on stage and permissions.

Pushing code and deployments

When you push code to an instance's branch, CICDoo picks it up and deploys it. You can follow the resulting jobs in the console's Queue tab, and the new commits show up in the Commits tab. While work is in progress, a "Working on instance" banner appears at the top of the console and clears when the instance reports completion.

Related articles

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

Previous Connecting GitLab Next Adding a server

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