Quickstart

Already have an OpenShift cluster and an LLM endpoint? Three steps and you’re running. No cluster yet? See Local cluster (CRC).

Install the operator

Operators → OperatorHub, search “OpenStack Lightspeed (Community)”, click Install. Currently published for OpenShift 4.16 and 4.18 — on other versions, or if it’s not showing up, see Installation Guide for the source-based alternative.

Create the secret and CR

Save as secret.yaml, with your own LLM API key:

apiVersion: v1
kind: Secret
type: Opaque
metadata:
  name: openstack-lightspeed-apitoken
  namespace: openstack-lightspeed
stringData:
  apitoken: <your-llm-api-key>

Save as cr.yaml, with your own endpoint, model, and provider type (see Supported LLM providers (llmEndpointType) for valid values):

apiVersion: lightspeed.openstack.org/v1beta1
kind: OpenStackLightspeed
metadata:
  name: openstack-lightspeed
  namespace: openstack-lightspeed
spec:
  llmEndpoint: https://<llm-provider-host>:<port>/v1
  llmEndpointType: <provider-type>
  llmCredentials: openstack-lightspeed-apitoken
  modelName: <model-name>

Then apply both:

oc apply -f secret.yaml
oc apply -f cr.yaml

Self-hosted endpoint with a self-signed certificate? See Installation Guide and Configuration for the full field reference.

Open the console

oc whoami --show-console

Open that URL and use the Lightspeed widget (lower-right corner).