---
title: Installing the eBPF Manager Operator
---

# Installing the eBPF Manager Operator {#bpfman-operator-install}

To manage eBPF programs across your cluster nodes, you can install the eBPF Manager Operator by using the OpenShift Container Platform CLI or the web console. This Operator provides a standardized way to deploy, monitor, and secure eBPF-based networking and observability tools.

> [!IMPORTANT]
> eBPF Manager Operator is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.
>
> For more information about the support scope of Red Hat Technology Preview features, see [Technology Preview Features Support Scope](https://access.redhat.com/support/offerings/techpreview/).

## Installing the eBPF Manager Operator using the CLI {#nw-bpfman-operator-installing-cli_bpfman-operator-install}

To manage eBPF programs across your cluster nodes, you can install the eBPF Manager Operator by using the OpenShift Container Platform CLI. This process involves creating a dedicated namespace and subscribing to the Operator to enable node-level networking and observability tools.

**Prerequisites**

- You have installed the OpenShift CLI (`oc`).
- You have an account with administrator privileges.

**Procedure**

1. To create the `bpfman` namespace, enter the following command:

   ```terminal
   $ cat << EOF| oc create -f -
   apiVersion: v1
   kind: Namespace
   metadata:
     labels:
       pod-security.kubernetes.io/enforce: privileged
       pod-security.kubernetes.io/enforce-version: v1.24
     name: bpfman
   EOF
   ```
2. To create an `OperatorGroup` CR, enter the following command:

   ```terminal
   $ cat << EOF| oc create -f -
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: bpfman-operators
     namespace: bpfman
   EOF
   ```
3. Subscribe to the eBPF Manager Operator.

   1. To create a `Subscription` CR for the eBPF Manager Operator, enter the following command:

      ```terminal
      $ cat << EOF| oc create -f -
      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: bpfman-operator
        namespace: bpfman
      spec:
        name: bpfman-operator
        channel: alpha
        source: community-operators
        sourceNamespace: openshift-marketplace
      EOF
      ```
4. To verify that the Operator is installed, enter the following command:

   ```terminal
   $ oc get ip -n bpfman
   ```

   ```terminal {title="Example output"}
   NAME            CSV                                 APPROVAL    APPROVED
   install-ppjxl   security-profiles-operator.v0.8.5   Automatic   true
   ```
5. To verify the version of the Operator, enter the following command:

   ```terminal
   $ oc get csv -n bpfman
   ```

   ```terminal {title="Example output"}
   NAME                                DISPLAY                      VERSION   REPLACES                            PHASE
   bpfman-operator.v0.5.0              eBPF Manager Operator              0.5.0     bpfman-operator.v0.4.2              Succeeded
   ```

## Installing the eBPF Manager Operator using the web console {#nw-bpfman-operator-installing-console_bpfman-operator-install}

To manage eBPF programs across your cluster nodes, you can install the eBPF Manager Operator by using the OpenShift Container Platform web console. You can use the eBPF Manager Operator to enable node-level networking and observability tools through the OperatorHub interface.

**Prerequisites**

- You have installed the OpenShift CLI (`oc`).
- You have an account with administrator privileges.

**Procedure**

1. Install the eBPF Manager Operator:

   1. In the OpenShift Container Platform web console, click **Ecosystem** → **Software Catalog**.
   2. Select **eBPF Manager Operator** from the list of available Operators, and if prompted to **Show community Operator**, click **Continue**.
   3. Click **Install**.
   4. On the **Install Operator** page, under **Installed Namespace**, select **Operator recommended Namespace**.
   5. Click **Install**.
2. Verify that the eBPF Manager Operator is installed successfully:

   1. Navigate to the **Ecosystem** → **Installed Operators** page.
   2. Ensure that **eBPF Manager Operator** is listed in the **openshift-ingress-node-firewall** project with a **Status** of **InstallSucceeded**.

      > [!NOTE]
      > During installation an Operator might display a **Failed** status. If the installation later succeeds with an **InstallSucceeded** message, you can ignore the **Failed** message.

      If the Operator does not have a **Status** of **InstallSucceeded**, troubleshoot using the following steps:

      - Inspect the **Operator Subscriptions** and **Install Plans** tabs for any failures or errors under **Status**.
      - Navigate to the **Workloads** → **Pods** page and check the logs for pods in the `bpfman` project.

**Additional resources**
{._additional-resources}

- [Deploying a containerized eBPF program](/openshift-docs-markdown/networking/networking_operators/ebpf_manager/ebpf-manager-operator-deploy#bpfman-operator-deploy)
- [Configuring Ingress Node Firewall Operator to use the eBPF Manager Operator](/openshift-docs-markdown/networking/networking_operators/ingress-node-firewall-operator#bpfman-infw-configure_ingress-node-firewall-operator)