rpk cloud byoc

Manage a Redpanda Cloud BYOC agent.

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.


rpk cloud byoc [command] [flags]


Value Type Description



The client ID of the organization in Redpanda Cloud.



The client secret of the organization in Redpanda Cloud.

-h, --help


Help for byoc.



The redpanda ID of the cluster you are creating.



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


Override rpk configuration settings. See rpk -X or execute rpk -X help for inline detail or rpk -X list for terser detail.



Profile to use. See rpk profile for more details.

-v, --verbose


Enable verbose logging.