As many of you know, GNS3 1.0 was released this Monday to all of us early testers who contributed a few months back. Here is my review on getting it setup, and some of the limitations of it thus far!


So finally the long awaited GNS3 1.0 ER has been released to us tester! As you can see from the screenshot above, I was able to get a switch up and working on it!

To get it working, I followed the guide that grossmj wrote on GNS3’s forums

1. VMWorkstation, VMPlayer, Oraclebox, or some kind of visualization program
2. ISO of debian-jessie-DI-a1-i386–netinst.iso that you can google for
3. IOU Images for the switches (and routers if you’d like) along with the license file
4. Some Linux CLI experience (or persistence with google searches!)
5. The GNS3 linux files ( and

HOW TO INSTALL (following grossmj’s guide)
1. Install your copy of Debian in your vm

2. Update the software repos by opening up a Terminal window and typing in “apt-get update“. You may need to run as “root” user so “su” to it if it complains that it can’t do it.

3. Place the GNS3 files and and place them on your desktop (or wherever you’d like).

4. Next, let’s install some Python tools (Python2.7 is installed by default but I just followed the guide). Hit “Yes” if prompted.
apt-get install python3
apt-get install python3-setuptools
apt-get install python3-pyqt4
apt-get install python3-ws4py

5. Next up, for the file let’s cd to the directory and then type in unzip This will unzip the .zip a folder in the same dir you did the command from. Next, issue a cd gns3-gui-master to enter the folder and we’ll install the files with Python via the command python3 install

6. Now we’ll install some more Python components …. type in the following commands and hit Yes if prompted.
apt-get install python3-zmq
apt-get install python3-tornado
apt-get install python3-netifaces

7. For the next portion, we’ll unzip the file. Let’s cd to the directory where the file is (for me its on the desktop) and issue the command unzip Now like we did in step 5, we’ll cd inside the unzipped folder contents and install it via python3 install

8. grossmj mentions that we need to “Fix the missing library for IOU”. Not sure for what but who am I to question one of the GNS3 programmers? In our terminal window issue the command apt-get install libssl1.0.0 and then type in ln -s /usr/lib/i386-linux-gnu/ /usr/lib/ The latter commands links the two paths together. For more info on links, read this article

9. Now we’ll install the IOUYAP. Download it from … z/download and as usual place it on your desktop (or wherever but I like the desktop). On our terminal window once downloaded browse to where you put the file (for me the desktop) and issue the command tar zxvf iouyap.tar.gz and then we’ll run a command to copy the ioyap to the /usr/local/bin directory. Run this command to copy it cp iouyap /usr/local/bin/iouyap. For more info on the tar command, lookup

10. Now this part is the hardest part of install GNS3 1.0 alpha….specifying the IOURC License file. Of course for legal reasons we can’t go in details on how to do this but the GNS3 forum has plenty of help on this! Just like we can’t hand out images for GNS3 0.8.5 I can’t hand these out either. Which leads me to say how is this release of GNS3 not illegal since one needs to….but I digress :) But if you got it I can tell you what you need to do next.

To clean up our terminal window, open up a new terminal window and let’s launch GNS3 by simply typing “gns3”. The GUI should pop up. Enter your GNS3 username GNS3XXXX and email associated with it. Now go to EDIT > PREFERENCES > IOU ON LINUX > and in the first field “Path to IOU” browse to your license file. Note if it isnt in the right format if you click OK and GNS3 doesn’t “accept” it, the window will not close (no error pops up).  If the GNS3 window “accepts” the license key it’ll close and you’ll know it took.

11. Now we’ll also specify the location of that IOUYAP file we had before. Its in the same window where we specified the license file. In GNS3 go to EDIT > PREFERENCES > IOU ON LINUX > and under the “Path to iouyap (local linux server only)” browser to the file. Hit OK.

12. Now similar to what we did for GNS 0.8.5. we need to add the actual images. To specify the images, go to EDIT > PREFERENCES > IOU DEVICES and then click on the “…” on IOU PATH to browse to where you have you IOU images.  Once you do, hit SAVE then OK.

13. One extra step I had to do to install putty on the OS. On our terminal window to install putty type in “apt-get install putty” and then in GNS3 to we’ll need to change app used to console to our IOU devices. In GNS3, go to EDIT > PREF > GENERAL > CONSOLE APPS tab > and on the pulldown window under Preconfigured commands select PUTTY and then hit OK.

14. And your set! Pull out your IOU device and rightclick and hit START. If all goes well, nothing pops up in the console window and the green circle on the right stays green! :) Right click the device and hit Console to open up your session with putty!


Stay tuned for more articles on GNS3 1.0. And I’m sure theres other ways to get this working! Please comment below on the ways you got your GNS3 1.0 working!

William Zambrano

William Zambrano

NYC networkers is run by William Zambrano, a passionate network engineer who has been in the IT industry for eight years who posts up blog articles, YouTube videos, and holds events in the NYC area. He lives in Queens, New York and has consulted in various different companies in the NY area. Previously William worked as a Cisco Certified Systems Instructor (CCSI) but now currently works for Arista Networks serving as a Systems Engineer. William can be reached by email at

More Posts - Website

Follow Me: