Instances & Console

Creating an instance

How to create a new instance from the Console sidebar and what the instance header shows you.

The Console sidebar

Open a project and you land in the Console. The left sidebar lists all instances of the project, grouped by stage:

  • Production (green dot)
  • Staging (amber dot)
  • Development (blue dot)

Each entry is the branch name of an instance. Click one to open its console. A stage shows "No instances" when it is empty. The sidebar also has a Projects link to go back to your project list and a Project Settings link at the bottom.

Creating a new instance

New instances are created in the Staging or Development groups. Next to each of those group headers there is a small plus (+) button.

  1. In the Console sidebar, click the plus button next to Staging or Development.
  2. In the Create Instance dialog, enter a Branch Name (for example, feature-xyz).
  3. Check the Fork From field. This is the base branch the new branch is created from. It is pre-filled with your project's default branch (for example main, master, or 18.0), and you can change it.
  4. The Stage field shows the stage you picked, based on which plus button you clicked.
  5. Click Create. CICDoo creates the branch and takes you to the new instance once it is ready.

In a workspace, the plus button is only visible to members who have permission to create instances.

Reading the instance header

At the top of every instance console you see:

  • The branch name as the page title.
  • A stage badge: green for Production, amber for Staging, blue for Development.
  • A status indicator dot with a label such as Checking, Online, Offline, Down, or Degraded.
  • If external uptime monitoring is active, a 30 day uptime percentage and average response time in milliseconds.
  • The instance domain underneath the title.
  • An Open Instance button that opens the running Odoo instance in a new browser tab.

Below the header is a row of quick actions (Restart, Connect, Merge, Stop, and Remove where applicable) and the tab bar with Commits, Access, Queue, Logs, Monitoring, Backups, and Settings.

For what happens after creation, see Deployments and the job queue. For restarting or removing an instance, see Restarting, stopping and removing an instance.

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.