GNS3: Instalasi di Ubuntu 26.04 + VENV + docker

Berikut cara instalasi GNS3 di Python virtual environment menggunakan folder:

~/Apps/GNS3

Catatan penting: instalasi via `pip/venv` cocok untuk GNS3 GUI + GNS3 server, tetapi emulator seperti QEMU/KVM, Dynamips, uBridge, VPCS, Wireshark, Docker tetap lebih aman dipasang dari package OS. GNS3 server memang bertugas mengelola QEMU/KVM, Docker, VPCS, VirtualBox, VMware, dan Dynamips. ([PyPI][1])

1. Install dependency OS

Untuk Ubuntu/Debian:

sudo apt update
sudo apt install -y \
  qemu-system-x86 \
  qemu-utils \
  libvirt-daemon-system \
  libvirt-clients \
  bridge-utils \
  virtinst \
  cpu-checker \
  wireshark \
  dynamips \
  vpcs

Tambahkan user ke grup yang diperlukan:

sudo usermod -aG kvm,libvirt,wireshark,docker $USER

Logout-login dulu setelah perintah di atas, atau reboot:

reboot

2. Buat folder kerja GNS3

mkdir -p ~/Apps/GNS3
cd ~/Apps/GNS3

3. Buat Python virtual environment

python3 -m venv venv

Aktifkan venv:

source ~/Apps/GNS3/venv/bin/activate

Pastikan prompt berubah, biasanya ada `(venv)`.

4. Upgrade pip

python -m pip install --upgrade pip setuptools wheel
python -m pip install --upgrade PyQt6 PyQt6-sip sip PyQt6-WebEngine


SITEPKG=$(python -c "import site; print(site.getsitepackages()[0])")

cat > "$SITEPKG/sip.py" <<'EOF'
from PyQt6.sip import *
EOF

5. Install GNS3 GUI dan server

Versi PyPI terbaru yang terlihat saat ini adalah gns3-gui 3.0.6, dirilis 28 Januari 2026. ([PyPI][2]) GNS3 juga menyatakan instalasi dari PyPI bisa dilakukan dengan `pip install gns3-gui` dan `gns3-server`; contoh rilis 3.0 memakai `gns3-gui==3.0.5` dan `gns3-server==3.0.5`. ([GNS3][3])

Install versi terbaru:

python -m pip install gns3-gui gns3-server

Atau kalau ingin versi dikunci supaya GUI dan server tidak mismatch:

python -m pip install gns3-gui==3.0.6 gns3-server==3.0.6

Cek hasil instalasi:

gns3 --version
gns3server --version

6. Jalankan GNS3

Aktifkan dulu venv:

source ~/Apps/GNS3/venv/bin/activate

Jalankan server:

gns3server

Di terminal lain, aktifkan venv lagi:

source ~/Apps/GNS3/venv/bin/activate
gns3

Atau langsung jalankan GUI saja:

~/Apps/GNS3/venv/bin/gns3

7. Buat script launcher supaya mudah

Buat file:

nano ~/Apps/GNS3/start-gns3.sh

Isi:

*!/usr/bin/env bash
cd ~/Apps/GNS3 || exit 1
source venv/bin/activate
gns3

Simpan, lalu:

chmod +x ~/Apps/GNS3/start-gns3.sh

Jalankan:

~/Apps/GNS3/start-gns3.sh

8. Buat shortcut desktop

mkdir -p ~/.local/share/applications
nano ~/.local/share/applications/gns3-venv.desktop

Isi:

[Desktop Entry]
Name=GNS3 VENV
Comment=Run GNS3 from ~/Apps/GNS3 Python virtual environment
Exec=/home/onno/Apps/GNS3/start-gns3.sh
Icon=gns3
Terminal=false
Type=Application
Categories=Network;Education;

Aktifkan:

chmod +x ~/.local/share/applications/gns3-venv.desktop
update-desktop-database ~/.local/share/applications 2>/dev/null

== 9. Struktur folder yang disarankan

~/Apps/GNS3/
├── venv/
├── start-gns3.sh
├── projects/
├── images/
└── appliances/

Buat foldernya:

mkdir -p ~/Apps/GNS3/projects ~/Apps/GNS3/images ~/Apps/GNS3/appliances

Di dalam GNS3 GUI, arahkan path project ke:

/home/onno/Apps/GNS3/projects

== 10. Kalau error PyQt

Kalau muncul error seperti modul Qt/PyQt tidak ditemukan, coba:

source ~/Apps/GNS3/venv/bin/activate
python -m pip install PyQt6 PyQt6-Sip PyQt6-WebEngine

Lalu jalankan lagi:

gns3

11. Kalau QEMU/KVM tidak jalan

Cek KVM:

ls -l /dev/kvm
groups

Pastikan user ada di grup `kvm` dan `libvirt`.

Tes QEMU:

qemu-system-x86_64 --version

Cek libvirt:

systemctl status libvirtd

Kalau belum aktif:

sudo systemctl enable --now libvirtd

== 12. Perintah uninstall

Kalau ingin hapus instalasi venv GNS3:

rm -rf ~/Apps/GNS3/venv
rm -f ~/.local/share/applications/gns3-venv.desktop

Package OS seperti QEMU/Wireshark tidak ikut terhapus.

Ringkasnya

Paling penting:

mkdir -p ~/Apps/GNS3
cd ~/Apps/GNS3
python3 -m venv venv
source venv/bin/activate
python -m pip install --upgrade pip setuptools wheel
python -m pip install gns3-gui gns3-server
gns3

Untuk penggunaan serius, tetap install juga:

sudo apt install qemu-kvm wireshark dynamips vpcs ubridge

[1]: https://pypi.org/project/gns3-server/?utm_source=chatgpt.com "gns3-server"
[2]: https://pypi.org/project/gns3-gui/?utm_source=chatgpt.com "gns3-gui"
[3]: https://gns3.com/gns3-3-0-released?utm_source=chatgpt.com "GNS3 3.0 Released!"