If this is your first time installing a GitOps Runtime in your Codefresh account on a clean cluster, follow these steps:

*[Complete prerequisites](#preparing-for-hybrid-gitops-runtime-installation): Before starting the installation, completepre-requisites.

*[Complete prerequisites](#preparing-for-hybrid-gitops-runtime-installation): Before starting the installation, completeprerequisites.

*[System requirements](#minimum-system-requirements): Check the minimum system requirements to ensure smooth installation.

*[Step-by-step installation](#install-first-gitops-runtime-in-account): Follow our step-by-step guide to install the Hybrid GitOps Runtime from the Codefresh UI.

Complete the prerequisites to ensure a smooth installation of Hybrid GitOps Runtime on a clean cluster.

Before initiating the installation, Codefresh automatically validates the`values.yaml` file to verify that the supplied values are correct.

A validation error will automatically terminate the installation.

You can disable automated validation and manually run the validation if desired.

The table below lists the settings validated in the`values` file.

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

|**Setting**|**Validation**|

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

|**userToken**|If explicitly defined, or defined as a`secretKeyRef` which exists in the current k8s context and the defined namespace.|

|**Account permissions**|If the user has admin permissions for the account in which they are installing the runtime.|

|**Runtime name**|If defined, and is unique to the account.|

|**Access mode**|{::nomarkdown}<ul><li>For tunnel-based (the default), if <codeclass="highlighter-rouge">accountId</code> is defined, and matches the account of the <codeclass="highlighter-rouge">userToken</code> defined in the file.</li><li>For ingress-based, if the hosts array contains at least one entry that is a valid URL (successful HTTP GET).</li><li>If both tunnel-based and ingress-based access modes are disabled, if <codeclass="highlighter-rouge">runtime.ingressUrl</code> is defined.</li></ul>{:/}|

|**gitCredentials**|{::nomarkdown}<ul><li>When defined, if includes a Git password either explicitly, or as a <codeclass="highlighter-rouge">secretKeyRef</code>, similar to <codeclass="highlighter-rouge">userToken</code>.</li><li>The password or token has the required permissions in the Git provider.</li></ul>{:/}|

If there is a validation failure, Codefresh terminates the installation with the error message:

To get more detailed and meaningful information on the reason for the validation failure, run:

where:

*`{NAMESPACE}` must be replaced with the namespace of the Hybrid GitOps Runtime.

You may want to disable automated validation for specific scenarios, such as to address false-negatives.

Do so by either adding the flag to the Helm install command or adding the relevant section to the values file.

{% highlight yaml %}

{% raw %}

...

installer: skipValidation: true

...

{% endraw %}

{% endhighlight %}

To manually validate the values file, run:

where:

*`<values_file>` is the name of the values.yaml used by the Helm installation.

*`<namespace>` is the namespace in which to install the Hybrid GitOps runtime, either the default`codefresh`, or the custom name you intend to use for the installation. The Namespace must conform to the naming conventions for Kubernetes objects.

*`<version>` is the version of the runtime to install.

If this is the first GitOps Runtime installation in your Codefresh account, install the Runtime from the Codefresh UI, following the step-by-step installation procedure.

The Codefresh`values.yaml` located[here](https://github.com/codefresh-io/gitops-runtime-helm/blob/main/charts/gitops-runtime/){:target="\_blank"}, contains all the arguments you can configure, including optional ones. See ???

The Codefresh`values.yaml` located[here](https://github.com/codefresh-io/gitops-runtime-helm/blob/main/charts/gitops-runtime/){:target="\_blank"}, contains all the arguments you can configure, including optional ones.

* Make sure you meet the[minimum requirements](#minimum-system-requirements) for installation