From ArchWiki
(Redirected from Gns3)
Jump to navigation Jump to search

Graphical Network Simulator (GNS3) allows you to simulate a network on your computer.

From the webpage:

GNS3 is an open source software that simulate complex networks while being as close as possible to the way real networks perform. All of this without having dedicated network hardware such as routers and switches.


GNS3 uses patched python extensions, python-aiohttp-cors-gns3AUR[broken link: package not found] and python-yarl-gns3AUR[broken link: package not found], which need to be installed before GNS3.

Note: That can potentially create trouble with other programs using the original extensions.

The gns3-guiAUR and gns3-serverAUR packages are needed to run the GNS3 GUI. The dynamipsAUR package are needed to simulate Cisco routers.

libvirt can be used to create the end devices "Cloud" (providing a virtual wan interfaces, isolating the tested network to the other devices in the main network) and NAT. To make libvirt work correctly, GNS3 needs dnsmasq and ubridgeAUR. Install them and ensure the libvirtd daemon is running before using GNS3 with Cloud and NAT end devices.

Adding virtual machines

When creating your topology (your virtual network), you most likely want to add machines to it. GNS3 supports QEMU, VirtualBox and VMware out of the box.


Install VirtualBox

To use VirtualBox machines for your topology you need to install virtualbox and virtualbox-sdk. To avoid any problems with GNS3 not finding VirtualBox it is recommended to install VirtualBox AFTER you install GNS3. If you already have VirtualBox installed, you should be able to just reinstall it.

If you do not install the virtualbox-sdk package you will not get the script and GNS3s needs this to connect the VMs.

Adding the GNS3 VM to VirtualBox

The official GNS3 VM should be used to increase performance. Go to GNS3 Github and download the VirtualBox version of the GNS3 VM with the exact same version number as your GNS3 version. Unzip and import the VM in VirtualBox.

To create a network connection between the GNS3 VM and the host OS a host-only network must be configured. In File > Host Network Manager, set up a host-only network. In most cases, it will be called vboxnet0 or similar. Note the IP address dedicated to the interface in the GUI. For some reason, VirtualBox does not assign the IP to the interface, nor does it enable it. Therefore, this must be performed manually in the terminal. See Network configuration#Routing table for more information on assigning IP addresses.

# ip addr add IP_address/subnet_mask dev vboxnet0
# ip link set dev vboxnet0 up

Launch the GNS3 startup wizard and select the GNS3 VM and it should be able to start the VM.

Adding VMs to GNS3

When the connection between GNS3 and VirtualBox have been made you need to tell GNS3 which VMs it should see and be able to use.

  1. In GNS3, click on Preferences > VirtualBox. Check that the path to (should be /usr/share/gns3/ and is set per default) is correct (if you get an OK when pressing the "Test Settings"-button, it works, otherwise see the installation step).
  2. Go to the VirtualBox Guest tab to add the VirtualBox VMs in GNS3. Choose an identifier name, a VM from the VM list (you may have to refresh the list using the provided button). To avoid confusion and possible errors, it is recomended to use the same identifier name as the name of the VM. When a VM is selected you can choose other options for it as well:
    • Number of NICs is the number of network interface cards you will see inside your VM (e.g. ifconfig on Linux, if you have 4 NICs on your VM, then set it to 4 in GNS3, if you have 1 NIC, then set it to 1 in GNS3).
    • Reserve first NIC for VirtualBox NAT to host OS is to you have your first network interface card (e.g. eth0 on Linux) configured with network address translation (NAT), allowing your VM to access your host network and Internet (if your host can access it of course).
    • Enable console support to activate a serial console access to your VM. Please note that serial console support must also be configured on the operating system running in your VirtualBox guest for this feature to work. Here is a howto for Debian/Ubuntu Linux.
    • Enable console server (for remote access) is to remotely access to your VM serial console. GNS3 creates a mini Telnet server that act as a proxy between the serial console and Telnet clients. This feature requires the Enable console support to be enabled.
    • Start in headless mode (without GUI) will hide the VirtualBox graphical interface when the VM is started. This option is mostly useful if you have configured the previously described console support.

Adding VMs to your topology

After you have told GNS3 which VMs is should be able to see you can drag and drop them in your topology. Simply select the computer-icon in the left sidebar. You can now choose "VirtualBox guest". Drag this to where you want to add your VM in your topology. When you drop it in you will be prompted about which VM to add. Select the one you want and click OK. You should now be able to boot the VM from GNS3 by right click -> start.


Tip: GNS3 has already added built-in support for VMware. You may follow the wizard instead of the manual steps below.

To use VMware in GNS3 you need to create a cloud in your GNS3 topology, and then in your VMware machine, connect it to the NIC of the cloud in your topology.

Instructions taken (and ported) from GNS3 forums:

  1. Select network adapter "Host only" to your Virtual machine in Vmware
  2. Check how this network adapter (vmnet1) is named (ifconfig should list it).
  3. Add a cloud to your workspace in GNS3.
  4. Configure the cloud and select the network adapter you just looked up.
    • Right Click on the cloud and select Configure.
    • Select the C0 on the cloud.
    • Select NIO Ethernet.
    • Select Generic Ethernet NIO.
    • Select the appropriate adapter from the drop-down menu and press the Add button.
    • The adapter for your virtual machine should now be added to the cloud.
  5. Connect cloud to your topology, for example to a router.
  6. Adding IP addresses (in the same subnet) to the Virtual machine and the emulated router in GNS3.
  7. Ping between router and virtual machine should now be successful, otherwise, try to redo the steps.

Connecting devices

When devices have been added to your topology you will need to connect them. Select the link-icon (the bottom icon in the left sidebar, looks sort of like a mouse or ethernet-port+rj45 connector), click on a device (like a switch). Next, click on the device (like a VM) you want to connect to the switch. You will be promted to select the NIC which should be used. When you have created all the links you want, click the link-icon in the left sidebar to deselect it, otherwise GNS3 will still be in 'create link'-mode.


VPCS is a simple virtual PC simulator, supported by GNS3 and useful to enhance the simulation of a full working network topology. To use it, install vpcsAUR.

Wireshark packet capture

Wireshark can be used with GNS3 to "sniff" packets from the links between devices of a virtual topology. Install it and create a symlink under ~/GNS3/wireshark/ directory:

$ ln -s /usr/bin/wireshark ~/GNS3/wireshark/


The following warning may be encountered:

The GNS3 VM (IP, NETWORK is not on the same network as the local server (IP, NETWORK, please make sure the local server binding is in the same network as the GNS3 VM

To fix this, go to the Edit > Preferences > Server > Host Binding dropdown menu, and change the binding of the local server to whichever IP address (subnet and mask) matches the IP address listed on the Information screen in the GNS3 VM. See