Chapter 2. Uninstalling OpenShift Pipelines


Cluster administrators can uninstall the Red Hat OpenShift Pipelines Operator by performing the following steps:

  1. Delete the custom resource (CR) for the optional TektonResult component, if this CR exists, and then delete the TektonConfig CR.

    Important

    If you uninstall the Operator without removing the CR of the optional component, you cannot remove the component later.

  2. Uninstall the Red Hat OpenShift Pipelines Operator.
  3. Delete the custom resource definitions (CRDs) of the operator.tekton.dev group.

Uninstalling only the Operator will not remove the Red Hat OpenShift Pipelines components created by default when you install the Operator.

You can remove the OpenShift Pipelines custom resources (CRs) to clean up the configuration before uninstalling the Operator. This involves deleting the optional TektonResult component, followed by the main TektonConfig CR.

Procedure

  1. In the Administrator perspective of the web console, navigate to Administration CustomResourceDefinitions.
  2. Type TektonResult in the Filter by name field to search for the TektonResult custom resource definition (CRD).
  3. Click the name of the TektonResult CRD to display the details page for the CRD.
  4. Click the Instances tab.
  5. If an instance appears, click the Options menu kebab for the displayed instance.
  6. Select Delete TektonResult.
  7. Click Delete to confirm the deletion of the CR.
  8. Repeat these steps, searching for TektonConfig in the Filter by name field. If any instances of this custom resource definition (CRD) exist, delete them.

    Note

    Deleting the CRs also deletes the Red Hat OpenShift Pipelines components and all the tasks and pipelines on the cluster.

    Important

    If you uninstall the Operator without removing the TektonResult CR, you cannot remove the Tekton Results component later.

You can uninstall the Red Hat OpenShift Pipelines Operator by using the OpenShift Container Platform web console to remove the OpenShift Pipelines service from your cluster. This process involves deleting the Operator subscription and its associated operand instances.

Procedure

  1. From the Operators OperatorHub page, use the Filter by keyword box to search for the Red Hat OpenShift Pipelines Operator.
  2. Click the Red Hat OpenShift Pipelines Operator tile. The Operator tile indicates the installation status.
  3. In the Red Hat OpenShift Pipelines Operator description page, click Uninstall.
  4. In the Uninstall Operator? window, select Delete all operand instances for this operator, and then click Uninstall.

    Warning

    When you uninstall the OpenShift Pipelines Operator, the uninstallation process deletes all resources within the openshift-pipelines target namespace where OpenShift Pipelines is installed, including the secrets you configured.

You can delete the operator.tekton.dev custom resource definitions (CRDs) to fully remove all OpenShift Pipelines traces from your cluster. This step ensures that no residual definitions remain after the Operator uninstallation.

Delete the CustomResourceDefinitions of the operator.tekton.dev group. The Red Hat OpenShift Pipelines Operator creates these CRDs by default during installation.

Procedure

  1. In the Administrator perspective of the web console, navigate to Administration CustomResourceDefinitions.
  2. Type operator.tekton.dev in the Filter by name box to search for the CRDs in the operator.tekton.dev group.
  3. To delete each of the displayed CRDs, complete the following steps:

    1. Click the Options menu kebab .
    2. Select Delete CustomResourceDefinition.
    3. Click Delete to confirm the deletion of the custom resource definition (CRD).
Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat Documentation

Legal Notice

Theme

© 2026 Red Hat
Back to top