> 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/guideline-for-enterprise/cloudeka-api-list/command-reference/cldkctl-flexi/instance/create.md).

# create

Create a flexi instance in your project. This command allows you to create a flexi instance.

## Usage

```
cldkctl flexi instance create [flags]
```

## Steps

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

#### Interactive Mode

1. Run the following command in your terminal:

```
cldkctl flexi instance create -i true
```

2. Enter the **instance name**.
3. Select the **image type**.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2FCNuGj7OhWNE9kBlVx52x%2Fcreateinstance1.png?alt=media&amp;token=222db88b-f489-409e-9e15-a435fc56a20f" alt=""><figcaption></figcaption></figure>

4. Select the **operating system family**.
5. Select the **operating system version**.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2F7LKCeZURCw7eMdhYLFFJ%2Fcreateinstance2.png?alt=media&amp;token=97707380-ae07-46b6-a66a-24b1dd421527" alt=""><figcaption></figcaption></figure>

6. Select the **zone**.
7. Select the **billing type**.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2F3v483ASobynRGbS7Hsyv%2Fcreateinstance3.png?alt=media&amp;token=9e0f03b8-c871-4c87-a759-f6636d37f7a7" alt=""><figcaption></figcaption></figure>

8. Select the **processor**.
9. Select the **processor variant**.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2FCwfmKBIc91sVHGRblWIk%2Fcreateinstance4.png?alt=media&amp;token=b8ddd3f2-d1bd-42eb-91a7-94edcce78801" alt=""><figcaption></figcaption></figure>

10. Select the **instance plan**.
11. Select the **instance size**.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2FfMWLis93R9TPE815Efyn%2Fcreateinstance5.png?alt=media&amp;token=72de1f1c-63c5-4a4f-88f0-92708e6b8a2b" alt=""><figcaption></figcaption></figure>

12. Select the **root disk storage type**.
13. Select the **root disk storage size**.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2FlOvlOIkbw7FTRBiHgK7X%2Fcreateinstance6.png?alt=media&amp;token=c61783a2-0db3-4924-a14e-e23dd7b31961" alt=""><figcaption></figcaption></figure>

14. Select the **number of data disks**.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2FKPhIPty5hUrkaMAaAmAI%2Fcreateinstance7.png?alt=media&amp;token=5d0150fb-2fed-4669-a135-4f4116eb90ea" alt=""><figcaption></figcaption></figure>

15. Select the **VPC**.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2FBbWHJ5xwlfIljSl44oLu%2Fcreateinstance8.png?alt=media&amp;token=21dd8fb5-05fa-4309-94e1-d1e54bd8f09b" alt=""><figcaption></figcaption></figure>

16. Select the **authentication method**.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2FBVOhegjBXL4egw7fSbQi%2Fimage.png?alt=media&amp;token=b0e6d574-f522-4ec1-bbc1-c133700814a6" alt=""><figcaption></figcaption></figure>

17. Enter the **password** if the authentication method is set to **Password**.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2FXpnk5ui3krqqJlwxP48E%2Fcreateinstance9.png?alt=media&amp;token=1fd26065-4b89-45f9-8cd4-ddec7ae9f003" alt=""><figcaption></figcaption></figure>

18. Confirm the instance creation by selecting **Confirm**.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2FgTS8fcsZIbYsqExFqcNj%2Fcreateinstance10.png?alt=media&amp;token=2a59bfca-25ac-4713-bb15-76c6a158de58" alt=""><figcaption></figcaption></figure>

19. Once completed successfully, the terminal displays the success message.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2F8eFQEfcZ9BTXA8m4Koi3%2Fimage.png?alt=media&amp;token=ab2322eb-7970-4c00-a2d5-b0f5604b0027" alt=""><figcaption></figcaption></figure>

#### Non-Interactive Mode

1. Provide all required values using command flags.
2. Run the command in your terminal.
3. Once completed successfully, the terminal displays the success message.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2Fs11QIkn3GcAKm01H2lBC%2Fnon%20interactive%20create%20instance.png?alt=media&amp;token=779f46ab-a9d2-4e4d-940f-6155f0e197a7" alt=""><figcaption></figcaption></figure>

## Flags

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

| Flag             | Shorthand | Default | Description                                                |
| ---------------- | --------- | ------- | ---------------------------------------------------------- |
| --amount int     |           | 1       | Number of instances to create                              |
| --auth-method    |           |         | Authentication method: password or ssh                     |
| --billing-type   | -b        |         | Billing type: Fixed, PPU, or Trial                         |
| --data-disks     |           |         | JSON array of data disks                                   |
| --flavor-id      |           |         | Instance size/flavor ID or name                            |
| --help           | -h        |         | help for create                                            |
| --image-id       |           |         | Custom image ID or name (for --image-type=custom)          |
| --image-os-id    |           |         | OS image ID or name (for --image-type=os)                  |
| --image-type     |           |         | Image type: os or custom                                   |
| --interactive    | -i        | false   | Run in interactive/TUI mode (true/false)                   |
| --name           | -n        |         | Instance name                                              |
| --password       |           |         | Instance password (for auth-method=password)               |
| --project        | -p        |         | Specify project ID                                         |
| --root-disk-size |           |         | Root disk package ID, or custom:\<size\_gb>                |
| --root-disk-type |           |         | Root disk storage type ID or name                          |
| --ssh-key-ids    |           |         | Comma-separated SSH key IDs (for auth-method=ssh)          |
| --tags           |           |         | Tags                                                       |
| --voucher-id     |           |         | Voucher ID, name, or code (required if billing-type=Trial) |
| --vpc-id         |           |         | VPC network ID or name                                     |
| --zone           |           |         | Zone ID or name                                            |
