[[_installing-operator]]
=== Installing the {project_operator} on a cluster

To install the {project_operator}, you can use:

* xref:_install_by_olm[The Operator Lifecycle Manager (OLM)]

[[_install_by_olm]]
==== Installing using the Operator Lifecycle Manager

ifeval::[{project_community}==true]
You can install the Operator on an xref:_openshift-olm[OpenShift] or xref:_kubernetes-olm[Kubernetes] cluster.

[[_openshift-olm]]
===== Installation on an OpenShift cluster
endif::[]

.Prerequisites

* You have cluster-admin permission or an equivalent level of permissions granted by an administrator.

.Procedure

Perform this procedure on an OpenShift 4.4 cluster.

. Open the OpenShift Container Platform web console.

. In the left column, click `Operators, OperatorHub`.

. Search for {project_name} Operator.
+
.OperatorHub tab in OpenShift
image:{project_images}/operator-openshift-operatorhub.png[]

. Click the {project_name} Operator icon.
+
An Install page opens.
+
.Operator Install page on OpenShift
image:{project_images}/operator-olm-installation.png[]

. Click `Install`.

. Select a namespace and click Subscribe.
+
.Namespace selection in OpenShift
image:images/installed-namespace.png[]
+
The Operator starts installing.

.Additional resources

* When the Operator installation completes, you are ready to create your first custom resource. See xref:_keycloak_cr[{project_name} installation using a custom resource].
ifeval::[{project_community}==true]
However, if you want to start tracking all Operator activities before creating custom resources, see the xref:_monitoring-operator[Application Monitoring Operator].
endif::[]

* For more information on OpenShift Operators, see the link:https://docs.openshift.com/container-platform/4.4/operators/olm-what-operators-are.html[OpenShift Operators guide].
 
ifeval::[{project_community}==true]

[[_kubernetes-olm]]
===== Installation on a Kubernetes cluster

.Prerequisites

* You have cluster-admin permission or an equivalent level of permissions granted by an administrator.

.Procedure

For a Kubernetes cluster, perform these steps.

. Go to link:https://operatorhub.io/operator/keycloak-operator[Keycloak Operator on OperatorHub.io].

. Click `Install`.

. Follow the instructions on the screen.
+
.Operator Install page on Kubernetes
image:{project_images}/operator-operatorhub-install.png[]

.Additional resources

* When the Operator installation completes, you are ready to create your first custom resource. See xref:_keycloak_cr[{project_name} installation using a custom resource]. However, if you want to start tracking all Operator activities before creating custom resources, see the xref:_monitoring-operator[Application Monitoring Operator].

* For more information on a Kubernetes installation, see link:https://operatorhub.io/how-to-install-an-operator[How to install an Operator from OperatorHub.io].

endif::[]