# pod

The create pod command deploys a new Pod in the Kubernetes cluster using a specified configuration. This command allows you to define the Pod's metadata, containers, environment variables, resource limits, and other specifications.

## Usage

```
cldkctl create pod [flags]
```

## Steps

Follow the steps below to run and view the result of this command:

1. You can create a Pod either by opening the built-in editor or by using a YAML configuration file.
2. To open the editor, run:

```
cldkctl create pod
```

3. The Pod manifest will open in your default text editor (default: vim). Edit the configuration as needed, then save and close the file to apply the changes.

<figure><img src="/files/VQhAB22274apuR0L3vLc" alt=""><figcaption></figcaption></figure>

4. Alternatively, you can prepare a YAML file that defines the Pod configuration, then save this file in the same directory where you will run the cldkctl command.
5. Use the --file flag to point to the YAML file.
6. (Optional) To specify a namespace or project, add the --default-namespace or --project flag.
7. Run the following command in your terminal:

```
cldkctl create pod --file [pod file name]
```

8. Replace \[pod file name] with the path to your YAML configuration file.
9. Once completed successfully, a message “✓ Pod created” will appear in your terminal.

<figure><img src="/files/QUfb0rWSTbRYpw3egzDk" alt=""><figcaption></figcaption></figure>

## Flags

{% hint style="info" %}
This command supports [global flags.](/cloudeka-api-list/global-flags.md) Refer to the Global Flags section for details.
{% endhint %}

| Flag       | Description                  |
| ---------- | ---------------------------- |
| -h, --help | Help for create pod command. |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cloudeka.ai/cloudeka-api-list/command-reference/cldkctl-create/pod.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.