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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.acecloud.ai/knowledge-base/compute/how-to-download-an-image-from-ace-cloud.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.