GNS3 installation in Linux

 GNS3 Installation in Linux

These instructions are for Ubuntu and all distributions based on it (like Linux Mint). 

    sandip@MyLap:~$ sudo add-apt-repository ppa:gns3/ppa

    sandip@MyLap:~$ sudo apt update

    sandip@MyLap:~$ sudo apt install gns3-gui gns3-server

(when prompted whether non-root users should be allowed to use wireshark and ubridge, select ‘Yes’ both times)

If you want IOU support

    sandip@MyLap:~$ sudo dpkg --add-architecture i386

    sandip@MyLap:~$ sudo apt update

    sandip@MyLap:~$ sudo apt install gns3-iou

Install the following packages:

    sandip@MyLap:~$ sudo apt-get install apt-transport-https ca-certificates curl software-properties-            common 

Import the official Docker GPG key:

    sandip@MyLap:~$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

Add the appropriate repo:

    sandip@MyLap:~$ sudo add-apt-repository \

Install Docker-CE:

 Error Solve Here:

We need to completely remove the leftover xia Docker repo to stop this message.

 

Final Fix: Remove the xia Docker repo reference

Run this command to find and delete it:

    sandip@MyLap:~$ sudo find /etc/apt/ -type f -name "*.list" -exec grep -l "xia" {} \;

 

This will list any files containing xia. You’ll most likely see:

/etc/apt/sources.list.d/official-package-repositories.list

/etc/apt/sources.list.d/additional-repositories.list

 

    sandip@MyLap:~$ sudo apt update

    sandip@MyLap:~$ sudo apt install docker-ce

sandip@MyLap:~$ sudo usermod -aG ubridge,libvirt,kvm,wireshark,docker $(whoami) usermod: group 'docker' does not exist

sandip@MyLap:~$

 

Finally, add your user to the following groups:

    ubridge libvirt kvm wireshark docker

 The error you're seeing (usermod: group 'docker' does not exist) indicates that the docker group hasn't been created yet on your system.

You can create the docker group manually and then add yourself to it. Here's how:

1. Create the Docker group:

         sandip@MyLap:~$ sudo groupadd docker

 2. Add your user to the groups (including the newly created docker group):

        sandip@MyLap:~$ sudo usermod -aG ubridge,libvirt,kvm,wireshark,docker $(whoami)

 

Restart your user session by logging out and back in, or restarting the system.

Debian-based Distribution

GNS3 is not available through apt; you will have to use pipx.

Refresh apt:

    sandip@MyLap:~$ sudo apt update

Install python and the required emulation & gui packages:

sandip@MyLap:~$ sudo apt install python3 python3-pip pipx python3-pyqt5 python3-pyqt5.qtwebsockets python3-pyqt5.qtsvg qemu-kvm qemu-utils libvirt-clients libvirt-daemon-system virtinst dynamips software-properties-common ca-certificates curl gnupg2

 

Use pipx to install gns3:

    sandip@MyLap:~$ pipx install gns3-server

    sandip@MyLap:~$ pipx ensurepath

    sandip@MyLap:~$ source ~/.bashrc

sandip@MyLap:~$ which gns3server

/home/sandip/.local/bin/gns3server

Alright! That means the version of gns3server you're using is from /usr/bin, likely installed via apt or a previous system package — not the one installed via pipx (which would be in /home/sandip/.local/bin/gns3server).

So you're probably still using an older system-wide GNS3 server instead of the newer 3.0.4 version installed via pipx.

FIX. Prioritize the pipx version

To make sure you're using the latest version installed via pipx, you need to put ~/.local/bin before /usr/bin in your $PATH.

1. Edit your .bashrc:

    sandip@MyLap:~$ vim ~/.bashrc

2. Add this line near the top:

export PATH="$HOME/.local/bin:$PATH"

3. Save and reload:

    sandip@MyLap:~$ source ~/.bashrc

    sandip@MyLap:~$ which gns3server

Use pipx to install gns3:

    sandip@MyLap:~$ pipx install gns3-server

    sandip@MyLap:~$ pipx install gns3-gui

To launch the GUI, we will need to prepare the virtual environment. Inject the GNS server and QT elements:

 Error Solve

Ahh, classic gns3 + pipx issue  — the error means your GNS3 GUI is installed, but it's missing PyQt and sip, which are required for the graphical interface to run.

Here's how to fix it:

Since you're using pipx, you'll need to install the missing dependencies within the GNS3 GUI environment.

Run this:

    sandip@MyLap:~$ pipx inject gns3-gui pyqt5 sip

    sandip@MyLap:~$ gns3 --version

    3.0.4

To launch the GNS3 Server

    sandip@MyLap:~$ gns3