---
title: "kafkabroker create"
slug: "kafkabroker-create"
updated: 2026-10-27T17:24:38Z
published: 2026-10-27T17:24:38Z
canonical: "docs.vastdata.com/kafkabroker-create"
---

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

# kafkabroker create

This command creates a Kafka [event broker configuration](/docs-5-3/docs/en/publishing-events-to-third-party-event-brokers) on the VAST cluster.

## Usage

```plaintext
kafkabroker create --name NAME
                   --addresses ADDRESSES
                   [--tenant-ID TENANT_ID]
```

## Required Parameters

| `--name NAME` | The name for the new Kafka broker configuration. |
| --- | --- |
| `--addresses ADDRESSES` | Enter one or more Kafka broker bootstrap URLs. Specify `ADDRESSES` as a comma-separated list of `<host>:<port>` pairs, where: - `<host>` is an IP address or FQDN of the Kafka broker server. - `<port>` is the port number. You can specify up to five `<host>:<port>` pairs. For example: `192.168.1.1:9092,192.168.1.2:9092` > [!TIP] > Tip > > Ensure that the hosts are accessible from the VAST cluster's management interface at the specified ports. |

## Options

| `--tenant-id TENANT_ID` | Add this option if you want to restrict use of this Kafka broker to a particular tenant. If this option is not specified, the Kafka broker will be available for all tenants. |
| --- | --- |

## Example

To create setup to connect to a Kafka broker at `192.168.1.4` that will be used to publish events from tenant 3 only:

```plaintext
vcli: admin> kafkabroker create --name mybroker --addresses 192.168.1.4:9092 --tenant-id 3
```