> For the complete documentation index, see [llms.txt](https://docs.cloudeka.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudeka.ai/cloudeka-api-list/command-reference/cldkctl-vm/create.md).

# 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. |
