Quick start

Check out our quick start tutorial to get up and running in the Codefresh platform with hosted or hybrid runtimes.

The tutorial is divided into these sections:

  • Provisioning runtimes
  • Creating and deploying an application
  • Triggering and creating a Delivery Pipeline

Each section indicates the runtime environment it is relevant to.

Provision runtimes

Based on your deployment model, start by provisioning the hosted or hybrid runtime. Hosted and hybrid runtimes can co-exist with each other.


Hosted runtimes are hosted on a Codefresh cluster and managed by Codefresh. You need to provision your hosted runtime once for your account.

  1. Provision a hosted runtime
    Provision the hosted runtime with a single click, and complete the setup for your hosted environment.


Hybrid runtimes: Hosted on a customer cluster and managed by the customer. You can provision multiple hybrid runtimes in the same account.

  1. Prepare for hosted runtime installation
    Verify your environment matches the requirements for installing Codefresh runtime.
  2. Install hybrid runtime
    Install the Codefresh runtime by downloading the CLI, installing the runtime, and validate successful installation in the UI

Deploy an application

  1. Create an application
    Create the codefresh-guestbook application in the Codefresh UI.
  2. Create and commit resources for application
    Create rollout and service resources, and commit these resources to deploy the codefresh-guestbook application.
  3. Update the image tag for application
    Update the image for the codefresh-guestbook application to trigger a rollout.

Trigger/create a Delivery Pipeline

Available for hybrid deployments.

  1. Trigger the Hello World example pipeline
    Configure the Git event to trigger the demo pipeline.
  2. Create a basic CI delivery pipeline
    Create a new CI delivery pipeline in Codefresh.