FedoraGNS3

FedoraGNS3 is a streamlined solution to simplify the setup and installation of GNS3 on Fedora-based systems. This repository provides a single script to configure dependencies, virtualization, and networking components required for GNS3.

Features

• Automatic Dependency Installation: Installs all necessary tools like qemu-kvm, libvirt, and gns3-gui.
• Virtualization Configuration: Enables and configures essential virtualization services.
• Network Setup: Configures bridge utilities and networking for seamless GNS3 operation.
• Silent Mode: Option to suppress output for a clean installation experience.

Repository Layout

FedoraGNS3
    ├── bin
    │   └── vpcs # VPCS binary for GNS3
    ├── LICENSE # MIT License file
    ├── README.md # Project documentation
    ├── scripts
    │   └── install.sh # Installation script for GNS3
    └── services
        └── start-libvirt-network.service # Autostartup service for virbr0 interface

Prerequisites

Ensure you have the following before proceeding:

1. Fedora OS (tested on Fedora 41 but should work on similar versions).
2. Administrative Privileges (sudo access).

Installation

1. Clone the Repository
   Download the repository to your local machine:

   git clone https://github.com/raminsamadi123/FedoraGNS3.git
   cd FedoraGNS3

2. Run the Installation Script
   Execute the script to install and configure GNS3:

   ./scripts/install.sh

   • Use the --silent flag for a quiet installation:

     ./scripts/install.sh --silent

3. Reboot Your System
   A reboot is required to apply changes:

   sudo reboot

Usage

Once installed:

• Launch the GNS3 GUI from your application menu or by typing gns3 in the terminal.
• Ensure your user is added to the necessary groups (e.g., libvirt, kvm, ubridge, wireshark).
• If you want to change your console you can do that with ptyxis --tab --execute "telnet {host} {port}" --title "{name} "
• If you want to change your vnc you can change it to for example vinagre

Troubleshooting

• If GNS3 fails to start or virtualization is not working, verify:
  • The libvirtd service is running:

    systemctl status libvirtd

  • Your CPU supports virtualization (If it shows 0 then it is disabled):

    grep -E -c '(vmx|svm)' /proc/cpuinfo

• For additional help, consult the GNS3 documentation.

Contributing

We welcome contributions! Here's how you can help:

1. Fork this repository.
2. Create a feature branch:

   git checkout -b feature-name

3. Commit your changes:

   git commit -m "Add a detailed description of your changes"

4. Push your branch:

   git push origin feature-name

5. Submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

VPCS License Notice

The vpcs binary included in the bin directory is provided by the VPCS project and is distributed under the BSD-2-Clause license. In compliance with this license, the original copyright notice and disclaimer are retained. For further details, please refer to the VPCS GitHub repository.

Acknowledgments

Special thanks to the Fedora community and GNS3 developers for creating an amazing networking simulation platform.