Chapter 1. Installing OpenShift Lightspeed


Enable OpenShift Lightspeed in your cluster by installing the OpenShift Lightspeed Operator and configuring the Service to interact with a large language model (LLM) provider.

1.1. Large language model (LLM) overview

Learn how the OpenShift Lightspeed Service uses large language models (LLMs) to generate intelligent, context-aware answers to your questions about OpenShift Container Platform.

You can configure Red Hat Enterprise Linux AI or Red Hat OpenShift AI as the LLM provider for the OpenShift Lightspeed Service. Either LLM provider can use a server or inference service that processes inference queries.

Alternatively, you can connect the OpenShift Lightspeed Service to a publicly available LLM provider, such as IBM watsonx, OpenAI, or Microsoft Azure OpenAI.

Note

Installing the OpenShift Lightspeed Operator does not install an LLM provider. You must have an LLM provider available for use before you install the OpenShift Lightspeed Operator.

You can use Red Hat Enterprise Linux AI to host an LLM.

For more information, see Generating a custom LLM by using RHEL AI.

You can use Red Hat OpenShift AI to host an LLM.

For more information, see About model serving.

1.1.3. IBM watsonx with OpenShift Lightspeed

To configure IBM watsonx as the LLM provider, you need an IBM Cloud project with access to IBM watsonx. You also need your IBM watsonx API key.

For more information, see the official IBM watsonx product documentation.

1.1.4. OpenAI with OpenShift Lightspeed

To configure OpenAI as the LLM provider with OpenShift Lightspeed, you need either the OpenAI API key or the OpenAI project name during the configuration process.

The OpenAI Service has a feature for projects and service accounts. You can use a service account in a dedicated project so that you can precisely track OpenShift Lightspeed usage.

For more information, see the official OpenAI product documentation.

To configure Microsoft Azure OpenAI as the LLM provider, you need a Microsoft Azure OpenAI Service instance. You must have at least one model deployment in Microsoft Azure OpenAI Studio for that instance.

For more information, see the official Microsoft Azure OpenAI product documentation.

1.2. About subscription requirements

Review the supported OpenShift Container Platform product subscriptions and account requirements necessary to activate and use the OpenShift Lightspeed Service in your environment.

Red Hat OpenShift Lightspeed requires a valid and active subscription to one of the listed products.

  • Red Hat OpenShift Kubernetes Engine
  • Red Hat OpenShift Virtualization Engine
  • OpenShift Container Platform
  • Red Hat OpenShift Platform Plus

1.3. About adding Operators to a cluster

Use the software catalog or OperatorHub to install Operators on your OpenShift Container Platform cluster. These tools use the Operator Lifecycle Manager (OLM) to manage your software.

Install the OpenShift Lightspeed Operator so that you can configure the OpenShift Lightspeed Service.

Prerequisites

  • You have deployed OpenShift Container Platform 4.16 to 4.19.
  • You have logged in to the OpenShift Container Platform web console as a user with the cluster-admin role.
  • You have successfully configured your large language model (LLM) provider so that OpenShift Lightspeed can communicate with it.

Procedure

  1. In the OpenShift Container Platform web console, navigate to the Operators OperatorHub page.
  2. Search for OpenShift Lightspeed.
  3. Locate the OpenShift Lightspeed Operator, and click to select it.
  4. When the prompt that discusses the community operator displays, click Continue.
  5. Click Install.
  6. Use the default installation settings presented, and click Install to continue.
  7. Click Operators Installed Operators to verify the OpenShift Lightspeed Operator installation. Succeeded displays in the Status column.

Install the OpenShift Lightspeed Operator so that you can configure the OpenShift Lightspeed Service.

Prerequisites

  • You have deployed OpenShift Container Platform 4.20 or later.
  • You have logged in to the OpenShift Container Platform web console as a user with the cluster-admin role.
  • You have successfully configured your large language model (LLM) provider so that OpenShift Lightspeed can communicate with it.

Procedure

  1. In the OpenShift Container Platform web console, navigate to the Ecosystem Software Catalog page.
  2. Click the Project drop-down list, and enable the toggle switch to show default projects.
  3. Enter openshift-marketplace in the search field.
  4. Click to select openshift-marketplace.
  5. Search for OpenShift Lightspeed.
  6. Locate the OpenShift Lightspeed Operator, and click to select it.
  7. When the prompt that discusses the OpenShift Lightspeed Operator displays, click Install.
  8. Use the default installation settings presented, and click Install to continue.
  9. Click Ecosystem Installed Operators to verify the OpenShift Lightspeed Operator installation. Succeeded displays in the Status column.
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

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

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

Theme

© 2026 Red Hat
Back to top