# Install an image

In GNS3, create a new blank project called IOSvL2.

We need to download the IOSvL2 appliance before beginning. I do an internet search for GNS3 marketplace and then select appliances. Locate the Cisco IOSvL2 appliance, click it and download the template.

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

I keep my images in C:\Users\\*username*\OneDrive\GNS3, adapt to your own path. In that path, I create \iosvl2 and save the template there. The lecturer will supply an image, copy that image to this folder also. I am using the image file:

**vios\_l2-adventerprisek9-m.ssa.high\_iron\_20200929**

1. In GNS3, go to File->Import Appliance
2. Select the file we just downloaded and open.
3. You should be offered the option of installing to the server only, click next.
4. You will be asked which QEMU binary to use, go with the default.
5. I am now asked for required files, GNS3 is looking for the OS image. It gives me three options, but this will change with every update, adapt!

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

6. In this example, I am going to install an image ending 55.E so adapt to whatever versions you are using.

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

GNS3 will take a few minutes to load the file.

7. Click Next to begin installing, GNS3 asks one more time if I would like to install it. I click Yes.

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

8. When finished, I get a password warning and then click finish.

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

9. Let us see if we have the switch available! If I click on the switch toolbar (2 horizontal arrows).
10. I can see this switch is loaded.
11. I can now drag an instance of the switch into the workspace and begin to work with it.
12. If I double click on the switch instance, I can access its configuration dialogue.

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


---

# 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://johnoraw.gitbook.io/lnp/2.gns3/appliances/install-an-image.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.