---
title: "The Grafana Alloy command-line interface | Grafana Alloy documentation"
description: "Learn about the Grafana Alloy command line interface"
---

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

# The Grafana Alloy command-line interface

The `alloy` binary exposes a command-line interface with subcommands to perform various operations.

The most common subcommand is [`run`](https://grafana.com/docs/alloy/next/reference/cli/run/) which accepts a configuration file and starts Alloy.

Available commands:

- [`convert`](https://grafana.com/docs/alloy/next/reference/cli/convert/): Convert an Alloy configuration file.
- [`fmt`](https://grafana.com/docs/alloy/next/reference/cli/fmt/): Format an Alloy configuration file.
- [`gql`](https://grafana.com/docs/alloy/next/reference/cli/gql/): Run a GraphQL query against a running Alloy instance.
- [`run`](https://grafana.com/docs/alloy/next/reference/cli/run/): Start Alloy with the Default Engine, given an Alloy syntax configuration file.
- [`otel`](https://grafana.com/docs/alloy/next/reference/cli/otel/): Start Alloy with the OTel Engine, given an OpenTelemetry Collector YAML configuration file.
- [`otel-supervisor`](https://grafana.com/docs/alloy/next/reference/cli/otel-supervisor/): Manage the OTel Engine with Grafana Fleet Management.
- [`tools`](https://grafana.com/docs/alloy/next/reference/cli/tools/): Read the WAL and provide statistical information.
- [`validate`](https://grafana.com/docs/alloy/next/reference/cli/validate/): Validate an Alloy configuration file or directory path.
- `completion`: Generate shell completion for the `alloy` CLI.
- `help`: Print help for supported commands.