> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firebolt.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Web UI

> Enable and open the optional web UI sidecar for a self-managed Firebolt engine.

A self-managed Firebolt engine can run an optional web UI for running queries from a browser. The UI runs as a sidecar container in each engine pod, points at the engine in the same pod over loopback (`http://localhost:3473`), and listens on port `9100`. It is off by default.

## Enable the UI

### Helm chart

Set `uiSidecar` on the engine spec in your values file and upgrade the release:

```yaml theme={"theme":{"light":"css-variables","dark":"css-variables"}}
engineSpec:
  uiSidecar: true
```

The chart adds the UI container to each engine pod and publishes port `9100` (named `web-ui`) on the engine Service.

### Firebolt Operator

Set `uiSidecar: true` on a `FireboltEngine`, or on a `FireboltEngineClass` to apply it to every engine that references the class:

```yaml theme={"theme":{"light":"css-variables","dark":"css-variables"}}
apiVersion: compute.firebolt.io/v1alpha1
kind: FireboltEngine
metadata:
  name: my-engine
spec:
  uiSidecar: true
```

The operator injects its built-in `engine-web` container into each engine pod. An engine value overrides the class value, which overrides the default (`false`). See the [`uiSidecar` field](./firebolt-operator/crd-reference/engine-crd-reference) in the CRD reference.

## Open the UI

The UI listens on port `9100` inside the engine pod. Forward that port from a pod to your workstation, then open `http://localhost:9100`:

```bash theme={"theme":{"light":"css-variables","dark":"css-variables"}}
kubectl -n firebolt get pods
kubectl -n firebolt port-forward <engine-pod> 9100:9100
```

With the Helm chart, port `9100` is also published on the engine Service, so you can forward the Service instead:

```bash theme={"theme":{"light":"css-variables","dark":"css-variables"}}
kubectl -n firebolt port-forward svc/my-engine-service 9100:9100
```