> For the complete documentation index, see [llms.txt](https://johnoraw.gitbook.io/lnp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://johnoraw.gitbook.io/lnp/2.gns3/appliances/install-an-image.md).

# 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="https://3973593522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbuXMcoW2S0X8KE0jLpdN%2Fuploads%2FYNso5cPx3eofnFmB0fkz%2Fimage.png?alt=media&amp;token=dd611c46-a8c0-48d4-8cf5-e84dcf787f3c" 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="https://3973593522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbuXMcoW2S0X8KE0jLpdN%2Fuploads%2Fcqv3Bh0KMnX2LlE9Vo8a%2Fimage.png?alt=media&amp;token=2ddb5440-84c8-4ac3-8bd1-75207019b4fd" 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="https://3973593522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbuXMcoW2S0X8KE0jLpdN%2Fuploads%2FlXd7m870tfgdKVuf2xWb%2Fimage.png?alt=media&amp;token=2b41c443-4a71-4e30-9504-2be8ef3ec855" 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="https://3973593522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbuXMcoW2S0X8KE0jLpdN%2Fuploads%2FFmEI9ejoRFE7OTC3iZnF%2Fimage.png?alt=media&amp;token=dd07816e-c094-4e13-be16-c13f03f1ea5f" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3973593522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbuXMcoW2S0X8KE0jLpdN%2Fuploads%2Fn2kAdyEmKoE0WzK1CpsD%2Fimage.png?alt=media&amp;token=857168f9-2d19-4dc6-be41-70a9cc7c3d29" 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="https://3973593522-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbuXMcoW2S0X8KE0jLpdN%2Fuploads%2FLkFsZgR1ZYbx34v4eTOp%2Fimage.png?alt=media&amp;token=bc0104b4-ec3e-4abe-b7d0-b07ae917437e" alt=""><figcaption></figcaption></figure>
