> For the complete documentation index, see [llms.txt](https://docs.acecloud.ai/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acecloud.ai/knowledge-base/compute/how-to-download-an-image-from-ace-cloud.md).

# How to Download an Image from Ace Cloud?

### **Overview** <a href="#overview" id="overview"></a>

This document provides step-by-step instructions on how to download an image from Ace Cloud. The process involves creating a snapshot of a volume, uploading it to the image service, and then downloading the image using the OpenStack Command-Line Interface (CLI).

### **Prerequisites** <a href="#prerequisites" id="prerequisites"></a>

* Access to an OpenStack project with the necessary permissions to create snapshots, manage volumes, and download images.&#x20;
* OpenStack CLI is installed on your machine.
* Python3-glanceclient installed on your machine.

### **Process**

#### **Step 1: Create a Snapshot** <a href="#step-1-create-a-snapshot" id="step-1-create-a-snapshot"></a>

To create a snapshot, follow the below steps:

a. [Login](https://customer.acecloudhosting.com/index.php?m=ace_product_register_addon\&action=login) to your account.

<figure><img src="/files/jyPTi9AbnyYlETNTQ5M5" alt=""><figcaption></figcaption></figure>

b. Navigate to **Compute** and then click on **Instances**.

<figure><img src="/files/0uRfvhjzVfJOem5uzMYb" alt=""><figcaption></figcaption></figure>

c. Select the Instance from the list and click on the action icon.

<figure><img src="/files/j3GfsBmb9LhrObPaeKc6" alt=""><figcaption></figcaption></figure>

d.  Choose **Create Snapshot.**

<figure><img src="/files/22vI288BqlA5SuGVD4lr" alt=""><figcaption></figcaption></figure>

e. Enter the **Snapshot Name** and hit **Submit**.

<figure><img src="/files/o6TjRN81jfgrWprGUhX9" alt=""><figcaption></figcaption></figure>

#### **Step 2: Upload the Volume to an Image** <a href="#step-3-upload-the-volume-to-an-image" id="step-3-upload-the-volume-to-an-image"></a>

Follow the steps below to learn how to upload the volume to an image:

a. Navigate to **Storage,** then click on **Volumes**, and locate the volume created from the snapshot.

<figure><img src="/files/gINQwR1AqaeMxyBQXHsW" alt=""><figcaption></figcaption></figure>

b. Click the actions icon next to the volume and select **Upload to Image**.

<figure><img src="/files/58oqZpzzC0mREpRScdfm" alt=""><figcaption></figcaption></figure>

c. Enter the Image Name, select the Disk Format (e.g., QCOW2, VDI), and click on **Upload**.

<figure><img src="/files/vX1Y9EDgNiDsmL2rYiOz" alt=""><figcaption></figcaption></figure>

#### **Step 3: Locate Your Image in the Image Section** <a href="#step-4-locate-your-image-in-the-image-section" id="step-4-locate-your-image-in-the-image-section"></a>

a. Navigate to **Storage** and then click on **Images.**

<figure><img src="/files/nrHwm7e7LdoGvoIepoqf" alt=""><figcaption></figcaption></figure>

b. Find the image you just uploaded and note the image name for use in the following steps.

<figure><img src="/files/Q6Wpu5pRcrx3oTgfyzIt" alt=""><figcaption></figcaption></figure>

#### **Step 4: Access the OpenStack CLI** <a href="#step-5-access-the-openstack-cli" id="step-5-access-the-openstack-cli"></a>

a. Open a terminal on your local machine.

b. Ensure you have the OpenStack CLI installed and configured with your OpenStack credentials.

#### **Step 5: List Available Images** <a href="#step-6-list-available-images" id="step-6-list-available-images"></a>

a. Run the following command to list all images and filter for your specific image:

```
OpenStack image list | grep -i "your-image"
```

&#x20;**Note:**&#x20;

* Enter your image name in place of  "your-image".
* Note the `Image ID` associated with your image, which you will need in the below step.

#### **Step 6: Install the Python3 Glance Client** <a href="#step-7-install-the-python3-glance-client" id="step-7-install-the-python3-glance-client"></a>

Run the below command to install the Glance client:

```
sudo apt install python3-glanceclient -y
```

This client is necessary to interact with the OpenStack Image service.

#### **Step 7: Download the Image** <a href="#step-8-download-the-image" id="step-8-download-the-image"></a>

a. Use the following command to download the image:

```
glance image-download --file 'your-image-name' <image-id> --progress
```

**Note:** Replace `'your-image-name'` with the name you want for the downloaded file and `<image-id>` with the ID of the image you fetched in the above step.

b. The image will be downloaded to the current directory with the specified file name.

### **Conclusion** <a href="#conclusion" id="conclusion"></a>

Following these steps, you can successfully create a snapshot of an instance, upload it to the Ace Cloud Image service, and download it to your local machine using the OpenStack CLI. This process helps back up instances, migrating them between environments, or obtaining a copy of an instance's image.