Installation from packages

Ubuntu-based distributions (64-bit only)

Debian-based distributions (64-bit only)

For Debian Jessie

For Debian Stretch

Arch Linux

Fedora

Gentoo

Sabayon

Alpine Linux

OpenSuse

Installation from source

Source archive

Installation from PyPi

Next step

Last updated
May 2, 2017

Contributors
Julien Duponchelle
Ricar Ganancial
Edit this Article
Last updated
May 2, 2017

Contributors
Julien Duponchelle
Ricar Ganancial
Edit this Article

GNS3 Installation on Linux

Installation from packages

Ubuntu-based distributions (64-bit only)

This instructions are for Ubuntu and all distributions based on it like Linux Mint.

sudo add-apt-repository ppa:gns3/ppa
sudo apt-get update
sudo apt-get install gns3-gui

If you want IOU support:

sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install gns3-iou

Debian-based distributions (64-bit only)

For Debian Jessie

Add the following lines to your /etc/apt/sources.list:

deb http://ppa.launchpad.net/gns3/ppa/ubuntu trusty main
deb-src http://ppa.launchpad.net/gns3/ppa/ubuntu trusty main

For Debian Stretch

Add the following lines to your /etc/apt/sources.list:

deb http://ppa.launchpad.net/gns3/ppa/ubuntu xenial main
deb-src http://ppa.launchpad.net/gns3/ppa/ubuntu xenial main

Finally, run the following commands in a terminal:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys F88F6D313016330404F710FC9A2FD067A2E3EF7B
sudo apt-get update
sudo apt-get install gns3-gui

Arch Linux

Note that this package is maintained by a third-party.

Run the following commands in a terminal:

yaourt -S gns3-gui gns3-server

Fedora

Note that this package is maintained by a third-party.

Starting with Fedora 24 packages are available in official repositories.

dnf install gns3-server gns3-gui wireshark wireshark-qt

WARNING21/12/16 the installation is broken: https://bugzilla.redhat.com/show_bug.cgi?id=1406711

WARNINGWayland in Fedora 25 seem to be not

For QEMU/KVM guests:

dnf install qemu-kvm qemu-system-x86

For Dynamips emulation, packages are still under review, however you can use this copr repository:

dnf copr enable athmane/gns3-extra
dnf install vpcs dynamips

For IOU support with Fedora

https://gns3.com/discussions/use-iou-images-in-64-bit-linux

Gentoo

Note that this package is maintained by a third-party.

Run the following commands in a terminal:

emerge -av net-misc/gns3-gui

Sabayon

Note that this package is maintained by a third-party.

Run the following commands in a terminal:

equo i net-misc/gns3-gui net-misc/gns3-converter net-misc/gns3-server

Alpine Linux

Note that this package is maintained by a third-party.

GNS3 is in testing repository of "edge" version.

apk update && apk add gns3-gui gns3-server

OpenSuse 

Note that this package is maintained by a third-party.

http://software.opensuse.org/download.html?project=home%3ADremor%3Agns3&package=gns3-gui

Installation from source

Source archive

The GNS3 source archive can be downloaded from here

Qemu is not provided you need to install it by hand.

Installation from PyPi

PyPi is the python package index. A repository for pure python package.

pip3 install gns3-gui
pip3 install gns3-server

You will also need to install all the dependencies by hand (qemu, iouyap, ubridge, dynamips...).

Next step

You need now to follow the setup wizard:

The setup wizard