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

Getting Started

The Dashboard and Infrastructure Map

How to read the Dashboard, use quick actions and recent deployments, change theme and language, switch workspace, and filter and pin containers on the live Infrastructure Map.

Read the Dashboard

The Dashboard is your home page. Click "Dashboard" in the left sidebar to open it. The stat cards at the top show:

  • Total Servers, Projects, Active Instances and Deployments.
  • Tickets: your support tickets, with how many are open.
  • Agent Hours Left: your remaining agent allowance plus any purchased credit. If you can manage billing, clicking the card opens the agent hours section of Billing.
  • Agent Tasks: shown when you are allowed to use agent tasks, with how many are in progress.
  • Tickets Resolved: tickets resolved this billing month.

If a project's subscription needs attention, a banner appears above the deployments table, for example when projects need a subscription or have become read-only because they are unpaid. Click "Review subscriptions" to go to Billing. See If a project subscription goes unpaid.

Start from the welcome panel

A brand new account with no servers, projects or instances sees a "Welcome to CICDoo" panel listing three steps: "Add your first server", "Create a project" and "Deploy an instance".

  1. Click "Add your first server" and complete the server form. See Adding a server.
  2. Click "Create a project" and complete the project form. See Creating a project.
  3. Open the project and deploy an instance. See Creating an instance.

The panel hides itself as soon as you have any server, project or instance.

Follow recent deployments

The "Recent Deployments" table lists your latest jobs (deploy, restart, upgrade, backup, restore and more) with the server, instance and branch, type, status and creation time. It refreshes on its own every few seconds.

  1. Find the job in the "Recent Deployments" table.
  2. Click "Logs" on its row to open the job log in a popup.
  3. Click "View all" to open the full Queue. See Deployments and the job queue.

Use quick actions

The "Quick Actions" card next to the table has shortcuts:

  • Add Server: opens the server form.
  • Add Project: opens the project form.
  • View Queue: opens the Queue page.
  • Settings: opens your Settings.

Change theme and language

The icons at the top right of every page control how the app looks.

  1. Click the theme icon ("Toggle theme") to cycle between Light, Dark and System. Hover it to see the current theme.
  2. Click the globe icon ("Language") and pick a language from the list. The current language has a check mark.

Check notifications and your account menu

  1. Click the bell icon to open "Notifications". The bell shakes and shows a badge when there is something new, such as a reply on one of your support tickets, a monitoring alert, or a warning that SSL certificate generation is temporarily unavailable.
  2. Click a notification, such as a ticket reply, to open what it refers to.
  3. Click your initials at the far right to open the account menu with "Settings", "Old platform" (the previous version of the platform) and "Sign out".

On wider screens, a stopwatch badge next to the theme icon shows your remaining agent hours, or "Out of hours" when the balance runs out. Click it to open the agent hours section of Billing. See Agent time and top-ups.

Switch workspace

If you belong to someone else's workspace, the sidebar shows a "Workspaces" section under the main menu.

  1. In the sidebar, find the "Workspaces" section.
  2. If the list is long, type in the "Filter workspaces…" box to narrow it.
  3. Click a workspace name to switch into it. Its dashboard opens, and the workspace you are in is highlighted.

Inside a workspace, the menu only shows the areas your permissions allow. See Workspaces and team collaboration.

If any project needs a subscription, a small billing badge also appears at the top of the sidebar, such as "1 project unpaid" or "2 projects read-only". Click "Review" on it to go to Billing.

Use the Infrastructure Map

The Infrastructure Map is a live view of which containers run on which servers. Each server is a card with its name, how many containers are online, CPU count, volume size, and live CPU, memory and disk bars. Inside each card every container (app or database) is a colored cell: green under 50 percent load, amber between 50 and 80 percent, red at 80 percent or more, and gray when offline. The legend under the map also marks containers running a backup or restore, reviving, stopped or unreachable.

  1. Click "Infrastructure Map" in the left sidebar.
  2. To narrow the view, pick a value in Server, Project, Stage or Type (App or Database). Click "Clear" to reset all filters.
  3. Hover a container to see its details: project, stage, branch, state, size, CPU, memory and more.
  4. Click a container to pin its details card. Click another container to move the pin, or press Esc or the "Unpin (Esc)" button to unpin.
  5. Click the instance name at the top of the card to open that instance's console.
  6. The map refreshes on its own. Click "Refresh" to force an update.

If a server card shows an extra "orphaned" volume size, that space is taken by "Volumes left behind by deleted or moved instances".

Related: What is CICDoo, Monitoring your instance, Server actions: deploy, logs and charts.

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

Previous Getting started: the onboarding wizard Next Monitoring your instance

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