Import the appliance

View appliance settings

Use the appliance

Last updated
June 23, 2017

Contributors
Julien Duponchelle
Edit this Article
Last updated
June 23, 2017

Contributors
Julien Duponchelle
Edit this Article

Import GNS3 appliance

NOTEThis document assumes that you already have both the GNS3 Graphical User Interface installed (GNS3-all-in-one) and the GNS3 VM integrated with GNS3. Please refer to other guides for more details on how to install the GNS3 all-in-one package and how to download and configure the GNS3 VM.

Import the appliance

In the GNS3 user interface, click File and then Import appliance:

Navigate to your Downloads folder, select the appliance and then click Open:

The Add appliance window displays. Review the summary and click Next >:

You need to select the Server type used. For this appliance type, the GNS3 VM is recommended. Select your choice of server and then click Next > :

The appliance server requirements are checked by GNS3. In this example the requirements are OK and the import can continue. Click Next > :

        

If the requirements check fails, rectify any issues before continuing.

An operating system is required for the new appliance. GNS3 will search various directories including your Downloads directory to attempt to find the correct image. In this example GNS3 has found one version of operating system file.

Select the version of file to install (if multiple are found) and then click Next >:

NOTEGNS3 will search the GNS3 images directory and the Downloads folder by default. If the file is not found, you need to click on the filename and then select the location of the operating system files.

NOTE Select Filename and not Version option because an appliance may require multiple files:

NOTEIf no file is found, you can click the Download button which will open a web browser and redirect you to the vendor’s website so you can download the relevant image:

A confirmation prompt is displayed. Click Yes to install the appliance:

A Summary of settings are displayed. Click Next > to continue:

A Usage screen is displayed. Click Finish to complete the appliance addition

The appliance is added to GNS3 and a success message displayed. Click OK:

Click the Browse all Devices menu option to view the newly imported GNS3 appliance:

View appliance settings

Optional: You can view the appliance settings by clicking Edit and then Preferences:

Optional: Click on the appliance type (will vary) to view the appliance details:

Use the appliance

Once you have imported the new appliance into GNS3, you can create topologies which include the new appliance. Drag and drop the appliance from the GNS3 Toolbar to the GNS3 Workspace. You may be prompted to upload the appliance operating system to the GNS3 VM. Click Yes to upload the appliance operating system.

The appliance operating system is uploaded to the GNS3 VM:

Build your GNS3 topology by dragging devices from the GNS3 Device Toolbar (1) to the GNS3 Workspace (2) and connecting them as desired:

Once you have created your topology, start the appliance: right click on the appliance and click Start):

Open a console to the device: right click on the appliance and click Console:

The appliance console displays:

Start other devices in your topology as required and configure your GNS3 network.

Congratulations! You have successfully imported an appliance.