How to Install GNS3 in 5 Easy Steps: A Beginner’s Guide

To install GNS3, you’ll download the free GUI from gns3.com, run the installer, set up the GNS3 VM in VirtualBox or VMware, then complete the setup wizard inside GNS3. Total time: about 25 minutes on a decent laptop. You don’t need to pay anything. GNS3 is open source and free.

This guide walks through every click. We’ve kept it short for beginners. By the end, you’ll have a working network lab where you can build CCNA, CCNP, and security labs from scratch.

GNS3 is the network simulator used by Walmart, AT&T, and NASA engineers. It’s also the tool most students pick when prepping for Cisco exams. Around 800,000 people use it actively.

What You’ll Need Before You Start

Before learning how to install GNS3, check these basics:

• A 64-bit Windows 10 or 11 machine (Linux and macOS work too, with minor steps)
• At least 4 GB RAM (16 GB recommended for serious labs)
• 35 GB free disk space on an SSD
• CPU virtualization enabled in BIOS (Intel VT-x or AMD-V)
• A free account on gns3.com (needed for download)

If you’re missing virtualization, GNS3 will run, but the VM won’t boot. We’ll cover the BIOS step below.

Heads up: running GNS3 on a Windows 7 machine still works on the latest 3.0.x release, but vendor IOS images often need 64-bit hosts. Stick to Windows 10 or newer if you can.

Step 1: Check System Requirements and Enable Virtualization

GNS3 emulates real Cisco IOS, Juniper, and FortiGate devices. That’s why it’s heavier than Packet Tracer. The GUI itself is light, but the GNS3 VM and the device images chew through RAM fast.

Three tiers of system requirements (per the official docs):

Tier	CPU	RAM	Storage
Minimum	2 logical cores + virtualization	4 GB	1 GB
Recommended	4 logical cores, AMD-V or Intel VT-X/EPT	16 GB	35 GB SSD
Optimal	Core i7/i9 or Ryzen 7/9, 8+ cores	32 GB	80 GB SSD

To enable virtualization:

1. Reboot your computer and tap the BIOS key (usually F2, F10, Del, or Esc)
2. Look under Advanced, CPU, or Security for Intel VT-x, Virtualization Technology, or SVM Mode
3. Enable it, save, exit
4. Boot back into Windows

You can verify it’s on. Open Task Manager, click the Performance tab, look at CPU, and check that Virtualization shows Enabled. If it says Disabled, redo the BIOS step.

Pro tip: If you’re on a corporate laptop, virtualization may be locked by IT policy. Hyper-V can also block VirtualBox. Disable Hyper-V and Memory Integrity if your VM refuses to start.

Step 2: Download GNS3 from the Official Site

This is the easy part. Don’t grab GNS3 from third-party download sites. They often bundle outdated installers with weird extras.

Steps:

1. Go to gns3.com/software/download
2. Click Sign Up and create a free account (email + password)
3. Confirm your email
4. Pick your OS (Windows is the most common path) and click Download
5. Save the .exe file (about 85 MB)

While that’s downloading, pop over to gns3.com/software/download-vm and grab the GNS3 VM for VirtualBox or VMware. Pick the same hypervisor you plan to use. You’ll need this in Step 4.

Why two downloads?

GNS3 has two parts. The GUI runs on your laptop. The VM runs the heavy emulation work in a sandboxed Linux environment. You can technically run GNS3 without the VM on Linux, but on Windows and macOS, the VM is the official supported path.

Step 3: Install the GNS3 GUI on Your Computer

Now run the installer you downloaded.

1. Double-click the GNS3-x.x.x-all-in-one.exe file
2. Click Next on the welcome screen
3. Accept the license, click I Agree
4. Pick the components to install. The defaults are fine. Make sure these are checked:

• WinPCAP or Npcap (packet capture)
• Wireshark (traffic analysis, optional but useful)
• Dynamips (router emulation)
• VPCS (lightweight virtual PCs)
• Solar-PuTTY (terminal access)

1. Choose your install location (the default C:\Program Files\GNS3 works)
2. Click Install and wait. The Wireshark and Npcap sub-installers will pop up. Accept the defaults for both.
3. When done, click Finish to launch GNS3

The first launch shows the Setup Wizard. Don’t click through it yet. We need the VM running first.

Common error: “Failed to install Npcap.” This happens when an older WinPCAP version is already there. Uninstall WinPCAP from Add or Remove Programs, then re-run the GNS3 installer.

Step 4: Set Up the GNS3 VM in VirtualBox or VMware

If you don’t have VirtualBox installed, grab it from virtualbox.org first. VMware Workstation Player also works and tends to perform better.

Import the GNS3 VM (VirtualBox path):

1. Open VirtualBox
2. Click File → Import Appliance
3. Browse to the .ova file you downloaded earlier
4. Click Next, then review the settings:

• RAM: bump it to 4096 MB minimum (8192 MB if you have it)
• CPUs: set to 2 or more

1. Click Import. This takes a few minutes.
2. After import, select the GNS3 VM and click Settings
3. Under System → Processor, enable Nested VT-x/AMD-V (this is critical for IOSv and other nested VMs)
4. Save and start the VM. You’ll see a console that shows the VM’s IP address. Leave it running.

For VMware Workstation:

The flow is almost identical. Use File → Open to import the .ovf or .vmx file from the GNS3 VM bundle. Make sure Virtualize Intel VT-x/EPT or AMD-V/RVI is ticked under Processors.

You should now see a green console screen with the IP address of your GNS3 VM. Keep it open.

Step 5: Complete the Setup Wizard and Build Your First Project

Switch back to GNS3. The Setup Wizard should still be open. If you closed it, go to Help → Setup Wizard.

1. Pick Run appliances in a virtual machine. Click Next.
2. Select GNS3 VM. The wizard auto-detects VirtualBox or VMware.
3. Allocate vCPUs and RAM. 2 vCPUs and 4 GB RAM is the floor.
4. Click Next. GNS3 starts the VM if it isn’t running.
5. The wizard runs a connectivity test. Look for green checkmarks. Click Finish.

You’re now ready to build a topology. To test the install:

1. In the main GNS3 window, click File → New Blank Project. Name it lab-01.
2. Drag two VPCS nodes (the small PC icons) onto the canvas
3. Connect them using the cable tool
4. Right-click each VPCS, click Start
5. Right-click again, choose Console. Type ip 192.168.1.1/24 on PC1 and ip 192.168.1.2/24 on PC2
6. From PC1 type ping 192.168.1.2

If you get replies, GNS3 is working. Congratulations. You’ve completed the install.

What to Do After You’ve Installed GNS3

A blank GNS3 install can’t do much on its own. You need device images. Cisco IOS images are licensed, so you’ll need to source them from your own equipment, a partner program, or a paid Cisco DevNet sandbox.

For practice, our CCNA Lab Workbook with EVE-NG ISO and Packet Tracer scenarios ships with 75 ready-to-load labs that work in both EVE-NG and GNS3. The configs, topologies, and IOS troubleshooting tasks line up with the 200-301 exam blueprint.

If you’re studying network automation, the CCNA Automation Workbook covers Python scripting, Ansible, and REST APIs against simulated devices. It pairs nicely with GNS3 for hands-on Cisco DevNet prep.

For more advanced labs, the CCIE Enterprise Infrastructure Workbook uses the GNS3 framework for full-blown lab scenarios on EIGRP, OSPF, BGP, MPLS, and SD-WAN.

If you’d rather learn live with an instructor, SMEnode Academy’s CCNA course walks through GNS3 setup in week one and builds working labs across the 12-week program.

Common GNS3 Install Errors and Fixes

“VM not starting” or “VBoxManage error”: Almost always virtualization. Recheck BIOS. Disable Hyper-V from Windows Features. Reboot.

“Server connection lost”: The GNS3 VM crashed or paused. Open VirtualBox, restart the VM, then in GNS3 click Edit → Preferences → GNS3 VM → Refresh.

“IOS image won’t load”: Your image is either a .bin you can’t legally use or it’s not unpacked. GNS3 needs decompressed .image files for IOSv. Use the Decompress IOS checkbox when you import.

Slow performance: Bump VM RAM to 8 GB. Move the GNS3 project folder to an SSD. Limit running devices to 4-6 at a time on a 16 GB host

FAQ