Docs Self-Managed Reference rpk Commands rpk profile rpk profile create This is documentation for Self-Managed v24.1. To view the latest available version of the docs, see v24.2. rpk profile create Create an rpk profile. There are multiple ways to create a profile. A name must be provided if not using --from-cloud or --from-rpk-container. You can use --from-redpanda to generate a new profile from an existing redpanda.yaml file. The special value current creates a profile from the current redpanda.yaml as it is loaded within rpk. You can use --from-rpk-container to generate a profile from an existing cluster created using rpk container start command. The name is not needed when using this flag. You can use --from-profile to generate a profile from an existing profile or from from a profile in a yaml file. First, the filename is checked, then an existing profile name is checked. The special value current creates a new profile from the existing profile with any active environment variables or flags applied. You can use --from-cloud to generate a profile from an existing cloud cluster ID. Note that you must be logged in with rpk cloud login first. The special value prompt will prompt to select a cloud cluster to create a profile for. You can use --set key=value to directly set fields. The key can either be the name of a -X flag or the path to the field in the profile’s YAML format. For example, using --set tls.enabled=true OR --set kafka_api.tls.enabled=true is equivalent. The former corresponds to the -X flag tls.enabled, while the latter corresponds to the path kafka_api.tls.enabled in the profile’s YAML. The --set flag is always applied last and can be used to set additional fields in tandem with --from-redpanda or --from-cloud. The --set flag supports autocompletion, suggesting the -X key format. If you begin writing a YAML path, the flag will suggest the rest of the path. It is recommended to always use the --description flag; the description is printed in the output of rpk profile list. Once the command completes successfully, rpk switches to the newly created profile. Usage rpk profile create [NAME] [flags] Flags Value Type Description -d, --description string Optional description of the profile. --from-cloud string [="prompt"] Create and switch to a new profile generated from a Redpanda Cloud cluster ID. --from-profile string Create and switch to a new profile from an existing profile or from a profile in a yaml file. --from-redpanda string Create and switch to a new profile from a redpanda.yaml file. --from-rpk-container - Create and switch to a new profile generated from a running cluster created with rpk container. -h, --help - Help for create. -s, --set strings Create and switch to a new profile, setting profile fields with key=value pairs. --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 profile clear rpk profile current