> For the complete documentation index, see [llms.txt](https://docs.cloud.olakrutrim.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloud.olakrutrim.com/basics/core-infrastructure/compute/machine-images.md).

# Machine Images

Machine Images allow users to upload and manage custom virtual machine images, which can later be used to launch VMs with pre-installed configurations and software. This service is useful for users who want reusable environments or want to migrate their VM setup.

***

### Uploading a Machine Image

Clicking **Upload Machine Image** opens a new page to configure and upload a custom image.

#### Required Fields:

| Field                    | Description                                                            |
| ------------------------ | ---------------------------------------------------------------------- |
| **Image Type**\*         | Selectable from a dropdown. Currently we support QCOW2 and RAW formats |
| **Machine Image Link**\* | The object storage link to the machine image                           |

#### Restrictions:

* **Max File Size:** 1024 GB
* **MIME Inspection:** Uploaded files will go through **Magic Byte (MIME type) validation**. This ensures the file is a valid and secure machine image, even if the extension appears valid. Files that fail this validation will be rejected.

**Uploading a machine image to the Krutrim Object storage bucket**

* Create an Object storage bucket using the steps mentioned [here](https://docs.cloud.olakrutrim.com/basics/core-infrastructure/storage/object-storage#creating-a-bucket)
* Once you have created the bucket, upload your image file to the bucket
* Once the file is uploaded, click on the three dots
* Click on the "three dots" near your image uploaded and click on the "Copy Presigned URL" button
* Copy and paste the URL to the Machine image link text field and click on upload

***

### Deleting a Machine Image

Each image has an **Actions** menu with an option to **Delete**.

Clicking **Delete** will open a confirmation pop-up:

> **Header:** Are you sure you want to delete the Machine Image?\
> **CTAs:**
>
> * Cancel
> * Confirm Deletion

Once confirmed, the image will be permanently deleted and cannot be used to create VMs.

***

### Downloading a Machine Image

Each image in the table also includes a **Download Machine Image** option in the **Actions** menu.

Clicking this will immediately begin downloading the machine image to your local system.
