# create

The cldkctl vm create command is used to create a new virtual machine (VM) in your project. This command launches an interactive mode that allows you to specify essential configuration details such as VM name, operating system, plan, instance size, storage, and root password.

## Usage

```
cldkctl vm create [flags]
```

## Steps

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

1. Run the following command in your terminal:

```
cldkctl vm create
```

2. Enter the VM Name to specify a unique identifier for the virtual machine.
3. Select the Operating System & Version from the available options.
4. Choose the Namespace where the virtual machine will be created.

<img src="/files/5DMappHmM8YW9QbxIV7T" alt="" height="308" width="576">

5. Select the Plan that defines the resource type, such as General or Compute Optimized.
6. Choose the Instance Size to determine the number of CPUs and memory allocation.
7. Specify the storage capacity under Nfs – Standard (Gi) in gigabytes.

<img src="/files/1vQBrfgynEf8nXCnUmOt" alt="" height="379" width="574">

8. Enter the Root Password for the virtual machine. The password must contain at least one uppercase letter, one digit, and one special character.
9. Confirm the creation process by selecting Confirm to proceed or Cancel to abort.

<img src="/files/t90b14waiFrY79tf6VSN" alt="" height="250" width="575">

10. Wait until the process is complete. Once successful, the terminal displays the message “✓ Virtual Machine created.”

<img src="/files/PmYYbFBR9WCNBV1zh36F" alt="" height="88" width="575">

## 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                                        |
| -------------------- | -------------------------------------------------- |
| -f, --file string    | Path to a YAML file for creating a VM.             |
| -h, --help           | Help for the vm create command.                    |
| -p, --project string | Specify the project ID.                            |
| --yaml               | Create a virtual machine using YAML configuration. |


---

# 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-vm/create.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.