For GitOps, Codefresh offers the option of installing Hosted and Hybrid GitOps Runtimes. Hosted GitOps Runtimes are fully managed and maintained by Codefresh. For a comparison, see[Hosted vs. Hybrid GitOps]({{site.baseurl}}/docs/installation/gitops/#hosted-vshybrid-gitops).

For GitOps, Codefresh offers the option of installing Hosted and Hybrid GitOps Runtimes.

Hosted GitOps Runtimes are fully managed and maintained by Codefresh.

This article describes how to install the Hosted GitOps Runtime to leverage GitOps capabilities.

For Hybrid GitOps Runtime installation, see[Hybrid GitOps Runtime installation]({{site.baseurl}}/docs/installation/gitops/hybrid-gitops-helm-installation/).

For a comparison between the two types of Runtime installations, see[Hosted vs. Hybrid GitOps]({{site.baseurl}}/docs/installation/gitops/#hosted-vshybrid-gitops).

{{site.data.callout.callout_warning}}

**IMPORTANT**

Codefresh is responsible for the_availability of Hosted GitOps Runtimes_.<br>

The Argo CD applications created in Hosted GitOps Runtimes are the customer's responsibility. Codefresh Support is happy to assist as needed.

{{site.data.callout.end}}

This article describes how to install the Hosted GitOps Runtime to leverage GitOps capabilities.<br>

For Hybrid GitOps Runtime installation, see[Hybrid GitOps Runtime installation]({{site.baseurl}}/docs/installation/gitops/hybrid-gitops-helm-installation/).

You can install a_single Hosted GitOps Runtime per Codefresh account_.

{: .table .table-bordered .table-hover}

| Item| Requirement|

| --------------| --------------|

|Kubernetes cluster| Server version 1.18 and higher to which to deploy applications|

|Git provider| {::nomarkdown}<ul><li>GitHub</li><!---<li>GitLab Cloud</li>--><li>Bitbucket Cloud</li><li>Gerrit</li></ul>{:/}|

|Kubernetes cluster| Server version 1.18|

|Target Kubernetes clusters| {::nomarkdown} <ul><li>At least one target cluster to which to deploy Argo CD applications. <br>The actual number of target clusters depends on package sizing.</li><li>Must have public access from Internet</li></ul>{:/}|

|Argo CD managed CRDs (Custom Resource Definitions)| Between 300 and 400 CRDs|

|Git provider| {::nomarkdown}<ul><li>GitHub</li><!---<li>GitLab Cloud</li>--><li>Bitbucket Cloud (contact Support)</li><li>Gerrit (contact Support)</li></ul>{:/}|

|Git repo for manifests| Up to 100MB|

|CMP (Cloud Management Platform) plugins| Only for Enterprise customers|

For a comparison between Hosted and Hybrid GitOps Runtimes, see[Hosted vs. Hybrid GitOps]({{site.baseurl}}/docs/installation/installation-options/#hosted-vshybrid-gitops).

If you have not provisioned a Hosted GitOps Runtime, Codefresh presents you with the setup instructions in the**Home** dashboard.

* In the Codefresh UI, fromOPS in the sidebar, select[Home](https://g.codefresh.io/2.0/?time=LAST_7_DAYS){:target="\_blank"}.

* In the Codefresh UI, fromOps in the sidebar, select[Home](https://g.codefresh.io/2.0/?time=LAST_7_DAYS){:target="\_blank"}.

Codefresh guides you through the three-step setup, as described below.

{% include

Connect your Hosted GitOps Runtime to a Git provider for Codefresh to create the required Git repos.

**Authorize access**

Based on the Git provider you select, you need to authorize access through OAuth or access token, and then select the Git organizations or accounts in which to create the required Git repos.

Based on the Git provider you select, you need to authorize access through OAuth oranaccess token, and then select the Git organizations or accounts in which to create the required Git repos.

**Git organizations/accounts**

Only authorized organizations are displayed in the list. To authorize organizations for the Codefresh application in GitHub, see[Authorize organizations/projects]({{site.baseurl}}/docs/administration/account-user-management/hosted-authorize-orgs/).

* Make sure your cluster has internet access

1. Click**Connect**.

1. In the Add Managed Cluster panel, copy the command`cf cluster add`, and run it in the terminal.

1. When prompted to select the`kube-context`, select from the list of available clusters as defined in`kubeconfig`.

{:start="5"}

1. Configure access to the IP addresses required. See[Codefresh IP addresses]({{site.baseurl}}/docs/administration/platform-ip-addresses/).

You have completed setting up your Hosted GitOps Runtime. You are ready to create applications, and connect third-party CI tools for image enrichment.

Optional. Create an application in Codefresh, deploy it to the cluster, and track deployment and performance in the Applications dashboard.

Optional. Create anArgo CDapplication in Codefresh, deploy it to the cluster, and track deployment and performance in the Applications dashboard.

1. Follow our quick-start to create and deploy the`codefresh-guestbook` application. Start with[Create application resources]({{site.baseurl}}/docs/quick-start/gitops-quick-start/create-app-specs/).

OR

Create your own application. See[Create an application]({{site.baseurl}}/docs/deployments/gitops/create-application/).

{:start="2"}

2. In the Codefresh UI, view your application in the[Applications dashboard](https://g.codefresh.io/2.0/applications-dashboard/list){:target="\_blank"}.

2. In the Codefresh UI, view your application in the[GitOps Apps dashboard](https://g.codefresh.io/2.0/applications-dashboard/list){:target="\_blank"}.

For more information, see[Monitoring Argo CD applications]({{site.baseurl}}/docs/deployments/gitops/applications-dashboard/).

Optional. Integrate Codefresh with the third-party tools you use for CI to enrich image information in deployments.

See[Image enrichment with integrations]({{site.baseurl}}/docs/gitops-integrations/image-enrichment-overview/)

See[Image enrichment with integrations]({{site.baseurl}}/docs/gitops-integrations/image-enrichment-overview/).

[Monitoring & managing GitOps Runtimes]({{site.baseurl}}/docs/installation/gitops/monitor-manage-runtimes/)

For GitOps, Codefresh offers the option of installing Hosted and Hybrid GitOps Runtimes. For a comparison, see[Hosted vs. Hybrid GitOps]({{site.baseurl}}/docs/installation/gitops/#hosted-vshybrid-gitops).

This article walks you through the process of installing Hybrid GitOps Runtimes in your Codefresh accounts using Helm charts.

For Hosted GitOps Runtime installation, see[Hosted GitOps Runtime installation]({{site.baseurl}}/docs/installation/gitops/hosted-runtime/).

This article walks you through the process of installing Hybrid GitOps Runtimes in your Codefresh accounts using Helm charts. You can install a single GitOps Runtime on a cluster. To install additional Runtimes in the same account, each account must be on a different cluster. Every Runtime within your account must have a unique name.

For Hosted GitOps Runtimes, see[Hosted GitOps Runtime Setup]({{site.baseurl}}/docs/installation/gitops/hosted-runtime/).

Within the same account, you can install_one Hosted and one Hybrid GitOps Runtime on a cluster_.

***Additional GitOps Runtime installations**

If you have already installed a GitOps Runtime in your account and want to install additional Runtimes on different clusters within the same account, you can continue with a[simplified installation](#install-additional-gitops-runtimes-in-account) from the Codefresh UI, or use[Terraform](/install-gitops-runtime-via-terraform).

When installing additional GitOps Runtimes, Git provider, Shared Configuration Repository, and the repository for the Helm chart, for example, are not required, as they have been already set up for your account.

{{site.data.callout.callout_warning}}

**ArgoCD password WARNING**

Terminology clarifications:

In the documentation, Hybrid GitOps Runtimes are also referred to as GitOps Runtimes.

Both deployment options are compliant with[SOC2 - Type2](https://us.aicpa.org/interestareas/frc/assuranceadvisoryservices/aicpasoc2report){:target="\_blank"}.

{% include image.html

lightbox="true"

file="/images/installation/soc2-type2-certified.png"

The diagram shows the high-level architecture for Codefresh SaaS deployment and its core components.

Codefresh Clients include the UI and the CLI.

For installation instructions and CLI command descriptions, see the[CLI documentation](https://codefresh-io.github.io/cli/getting-started/){:target="\_blank"}.

The diagram shows a high-level view of the Codefresh on-premises deployment, and its core components.

The Pipelines UI acts as a static file server that hosts and delivers all the user interface pages for Codefresh Pipelines. It provides visualization of pipelines, builds, third-party integrations and more.

The GitOps API serves as the primary gateway for the Codefresh GitOps module in the On-Premises platform. It interfaces between Codefresh GitOps, Git, and Argo CD, to sync

It utilizes a GraphQL interface to provide a user interface

The GitOps UI provides a unified, enterprise-wide view of deployments, Runtimes, clusters, and applications in the same location.

The Pipelines module comprises a set of microservices for managing Codefresh pipelines in the On-Premises platform.