> 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-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 
```

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%2Fgit-blob-53c4821bd2ca2a1d169bfa0578ae6086ee7c26e6%2Fimage.png?alt=media" 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%2Fgit-blob-3bda461303a73058822f0265884892ac0a81bed4%2Fimage.png?alt=media" 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%2Fgit-blob-6e5c976ea982c2508a76fbf00f8f2bc5c1403da6%2Fimage.png?alt=media" 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%2Fgit-blob-2f6551a440466c041605af8123c53d180e4370c9%2Fimage.png?alt=media" 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%2Fgit-blob-45db7f591a56cf562d412b506ab1c4f69f37d7f5%2Fimage.png?alt=media" 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%2Fgit-blob-f6319934ccbd98749fed40e7759436177f9b1345%2Fimage.png?alt=media" 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%2Fgit-blob-371f8fb1a4f3ebcf3ec9d76abbe28bf28e698145%2Fimage.png?alt=media" 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%2Fgit-blob-47730b9d78254597668f759fb0bf164158820b9e%2Fimage.png?alt=media" 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%2Fgit-blob-e7bf0e3198b28e128d9fcac0c9c0cc21e7728e26%2Fimage.png?alt=media" 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%2Fgit-blob-ed8aaf022ea1616d27671da7cc4e99f1375f9c8c%2Fimage.png?alt=media" 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%2Fgit-blob-d96308e85fd87981309b684a890abbe21c2238c0%2Fimage.png?alt=media" 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%2Fgit-blob-a977dc4cc26da629431bc639c592c4573b9a7419%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Non-Interactive Mode

1. Provide all required values using command flags.
2. Add `--auto-confirm` or `-y` to skip confirmation prompts in non-interactive mode.
3. Run the command in your terminal.
4. 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%2Fgit-blob-846b892ea7beea2cbace7f3ce92a02645a25e8b5%2Fimage.png?alt=media" 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             | 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                           |
| --help           | -h        |         | help for create                                   |
| --image-id       |           |         | Custom image ID (for --image-type=custom)         |
| --image-os-id    |           |         | OS image ID (for --image-type=os)                 |
| --image-type     |           |         | Image type: os or custom                          |
| --interactive    | -i        | false   | Run in interactive/TUI mode                       |
| --name           | -n        |         | Instance name (min 5 characters)                  |
| --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                         |
| --ssh-key-ids    |           |         | Comma-separated SSH key IDs (for auth-method=ssh) |
| --tags           |           |         | Tags                                              |
| --voucher-id     |           |         | Voucher ID (required if billing-type=Trial)       |
| --vpc-id         |           |         | VPC network ID                                    |
| --zone           |           |         | Zone ID                                           |
