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

Creating a project

Step-by-step walkthrough of the Create New Project wizard, from choosing GitHub or GitLab to assigning a server for each stage.

A project links one Git repository to your production, staging and development servers. You create it with the "Create New Project" wizard, which has three steps shown at the top: "Source", "Details" and "Servers".

Before you start

Note: In a workspace, the "Add Project" button is only shown to members who have the "Create projects" permission. See Member permissions and resource access.

Opening the wizard

  1. Open the Projects page.
  2. Click "Add Project" at the top right. The same button appears in the middle of the page when you have no projects yet, and in the Dashboard quick actions.
  3. The "Create New Project" window opens on the "Source" step.

Use "Next" and "Back" to move between steps. You can also click an earlier step in the indicator at the top to jump back. If "Next" is not available, a short hint next to the buttons tells you what is missing, for example "Select a repository to import" or "Select a production server".

Step 1: Source

  1. Under "Git Provider", pick GitHub or GitLab.
  2. If your account is not connected yet, a "GitHub Authorization Required" or "GitLab Authorization Required" notice appears. Click "Connect with GitHub" or "Connect with GitLab", or use the link below it ("use a classic token instead" for GitHub, "configure a Personal Access Token" for GitLab) to paste a token. Once connected, the notice changes to "GitHub Connected" or "GitLab Connected".
  3. Under "Project Type", choose one:
    • "New Project" (Start from scratch): CICDoo creates a new repository for you.
    • "Existing Project" (Import from GitHub or Import from GitLab): use a repository you already have.
  4. For "Existing Project", type at least 2 characters in the "GitHub Repository" or "GitLab Repository" search field, then pick a result with the mouse, or with the arrow keys and Enter. Each result shows the repository name, description, stars and default branch.
  5. Click "Next".

Step 2: Details

  1. Enter a "Project Name". It is shown across CICDoo and you can change it later. When you import a repository, it is pre-filled from the repository name.
  2. For a new repository only, enter a "Repository name": letters, numbers, dots, dashes and underscores, not starting with a dot or a dash.
  3. Pick the Odoo "Version" from the list. It covers 11.0 up to the latest releases and master.
  4. Pick the "Edition": "Community (Open Source)" or "Enterprise (Requires a classic token)".
  5. If you picked Enterprise on a GitHub project and no classic token is saved yet, an "Enterprise Edition Requires a Classic Token" notice appears. Click "Configure a classic token": the wizard returns to the "Source" step, where you paste the token in "GitHub Classic Token" and click "Save token". When a token is saved, the notice reads "Classic token configured - ready for Enterprise".
  6. Click "Next".

Step 3: Servers

The step opens with a "Summary" of your choices (provider, source, name, version and edition) so you can check them.

  1. Under "Server Assignment", search for and select a "Production Server". It is required. If you have exactly one server, it is selected for you.
  2. Optionally select a "Staging Server" and a "Development Server". You can add or change these later in the project settings.
  3. Click "Create Project".

If you have no servers yet, the step shows "No servers available" with a "Go to Servers" link. In a workspace where you cannot add servers, it asks you to contact your workspace owner instead.

After you create the project

Related: Branches and instances, Project GitHub settings and webhook, Production, staging and development stages, Tagging and filtering projects.

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

Previous Alert notifications (email and SMS) Next Connecting GitHub

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