# rpk cloud byoc install

> For the complete documentation index, see [llms.txt](https://docs.redpanda.com/llms.txt). Component-specific: [streaming-full.txt](https://docs.redpanda.com/streaming-full.txt)

---
title: rpk cloud byoc install
latest-operator-version: v26.1.4
# EOL = End-of-Life (support lifecycle status)
page-is-nearing-eol: "false"
page-is-past-eol: "true"
page-eol-date: April 30, 2025
latest-console-tag: v3.7.3
latest-connect-version: 4.93.0
docname: rpk/rpk-cloud/rpk-cloud-byoc-install
page-component-name: streaming
page-version: "24.1"
page-component-version: "24.1"
page-component-title: Streaming
page-relative-src-path: rpk/rpk-cloud/rpk-cloud-byoc-install.adoc
page-edit-url: https://github.com/redpanda-data/docs/edit/v/24.1/modules/reference/pages/rpk/rpk-cloud/rpk-cloud-byoc-install.adoc
page-git-created-date: "2023-08-04"
page-git-modified-date: "2024-07-24"
support-status: past end-of-life
---

<!-- Source: https://docs.redpanda.com/streaming/24.1/reference/rpk/rpk-cloud/rpk-cloud-byoc-install.md -->

Install the BYOC plugin.

Redpanda installs an agent service in your BYOC cluster. The agent then provisions infrastructure and, eventually, a full Redpanda cluster. The command downloads the `byoc` plugin from Redpanda Cloud and can execute many operations.

The BYOC command runs Terraform to create and start the agent. You first need a `redpanda-id` (or cluster ID); this is used to get the details of how your agent should be provisioned. You can create a BYOC cluster in the Redpanda Cloud UI and then come back to this command to complete the process.

This command downloads the BYOC managed plugin, if necessary. The plugin is installed by default if you run a non-install command. This command exists if you want to download the plugin ahead of time.

To define your `client_id` and `client_secret` use the `-X` flag.

## [](#example)Example

```bash
rpk cloud byoc install -X cloud.client_id=<your-client-id> -X cloud.client_secret=<your-client-secret>
```

## [](#usage)Usage

```bash
rpk cloud byoc install [flags]
```

## [](#flags)Flags

| Value | Type | Description |
| --- | --- | --- |
| -h, --help | - | Help for install. |
| --redpanda-id | string | The redpanda ID of the cluster you are creating. |
| --config | string | Redpanda or rpk config file; default search paths are /var/lib/redpanda/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml. |
| -X, --config-opt | stringArray | Override rpk configuration settings. See rpk -X or execute rpk -X help for inline detail or rpk -X list for terser detail. |
| --profile | string | Profile to use. See rpk profile for more details. |
| -v, --verbose | - | Enable verbose logging. |