---
title: "Set up Beyla | Grafana Beyla documentation"
description: "Learn how to set up and run Beyla."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Set up Beyla

You can run Grafana Beyla as a Docker container, or in Kubernetes with a Helm chart or your own manifests. Before you set up Beyla, check the [requirements and limitations](https://grafana.com/docs/beyla/next/introduction/requirements/).

- [Docker](https://grafana.com/docs/beyla/next/setup/docker/)  
  Run Grafana Beyla in a Docker container to instrument a service in another container, with the Docker CLI or Docker Compose.
- [Beyla Helm chart](https://grafana.com/docs/beyla/next/setup/kubernetes-helm/)  
  Install Grafana Beyla in Kubernetes with the Beyla Helm chart, customize its configuration, reduce its privileges, scrape its metrics with the Prometheus Operator, and pass OTLP credentials from a Secret.
- [Beyla Helm chart for Grafana Cloud](https://grafana.com/docs/beyla/next/setup/kubernetes-helm-appolly/)  
  Deploy Grafana Beyla with the Beyla Helm chart and send span metrics, service graph metrics, and traces directly to the Grafana Cloud OTLP endpoint for Application Observability and Knowledge Graph, with no collector in between.
- [Kubernetes Monitoring Helm chart](https://grafana.com/docs/beyla/next/setup/kubernetes-helm-k8s-monitoring/)  
  Learn how to deploy Beyla with the Kubernetes Monitoring Helm chart in Kubernetes for Knowledge Graph and Application Observability in Grafana Cloud.
- [Grafana Alloy Helm chart](https://grafana.com/docs/beyla/next/setup/helm-alloy/)  
  Learn how to instrument an application export data with Prometheus to Grafana Cloud
- [Kubernetes](https://grafana.com/docs/beyla/next/setup/kubernetes/)  
  Learn how to deploy Beyla in Kubernetes.
- [Security](https://grafana.com/docs/beyla/next/setup/security/)  
  Privileges and capabilities required by Beyla
- [Cilium compatibility](https://grafana.com/docs/beyla/next/setup/cilium-compatibility/)  
  Compatibility notes when running Beyla alongside Cilium
- [Use OBI with Grafana](https://grafana.com/docs/beyla/next/setup/use-obi/)  
  Replace Grafana Beyla features that OpenTelemetry eBPF Instrumentation (OBI) doesn't have, and configure OBI for Grafana Cloud Application Observability and Knowledge Graph.

For configuration options and data export modes, refer to [Configure Beyla](https://grafana.com/docs/beyla/next/configure/). By default, Beyla groups URL paths into routes with the `low-cardinality` routes decorator. To define route patterns for your application, refer to [Configure Beyla routes decorator](https://grafana.com/docs/beyla/next/configure/routes-decorator/).