Docs Self-Managed Reference rpk Commands rpk cloud rpk cloud byoc This is documentation for Self-Managed v24.1. To view the latest available version of the docs, see v24.2. 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. Usage rpk cloud byoc [command] [flags] Flags Value Type Description --client-id string The client ID of the organization in Redpanda Cloud. --client-secret string The client secret of the organization in Redpanda Cloud. -h, --help - Help for byoc. --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. Back to top × Simple online edits For simple changes, such as fixing a typo, you can edit the content directly on GitHub. Edit on GitHub Or, open an issue to let us know about something that you want us to change. Open an issue Contribution guide For extensive content updates, or if you prefer to work locally, read our contribution guide . Was this helpful? thumb_up thumb_down group Ask in the community mail Share your feedback group_add Make a contribution rpk cloud auth use rpk cloud byoc install