Bernhard's Homepage

Ostinato for GNS3

Ostinato for GNS3

Ostinato is an open-source network packet/traffic generator with a friendly GUI. For more information have a look at the fine documentation on

I decided to build my own Ostinato appliance, that is optimized for the use within GNS3. It's based on Docker, that allows a very efficient implementation. The Ostinato program itself has not been changed, all the documentation for Ostinato is still valid.

Ostinato Docker Appliance

The Docker appliance is pusblished as ehlers/ostinato. To import it into GNS3 open the preferences, go to Docker / Docker Containers and click on New. The “New Docker VM template” wizard will start and asks a couple of questions:

You have the option to edit the just created template, for example to change the symbol. When you’re done, leave the preferences with “OK”.

On the first time the Ostinato appliance is added into a project, it will be downloaded from the internet, about 150 MB. So depending on your internet access, it may take a while.

Use the Ostinato GUI within the Appliance

The easiest way is to use the GUI within the appliance. The major advantage is, that you don't have to install Ostination on your local computer.

A simple project could look like this:

Project with VM-GUI

The IP and MAC addresses of the Ostinato traffic interfaces are configured within the Ostinato GUI, so there's no need to configure IP addresses within the Linux OS of the appliance.

David Bombal has created some great videos, see his Ostinato playlist on YouTube. But these videos are based on older versions of the Ostinato VM.

Control the Ostinato Appliance from a GUI on your local Machine

Ostinato uses a client/server architecture. The GUI is used to define the packets, the server (also named drone) sends them out of the traffic interfaces. You can use an Ostinato GUI on your local machine to control the server/drone in the appliance.

For that you need an IP connection from your machine to the Ostinato appliance. That's done with a cloud node connected to any interface of the appliance.

Project with remote GUI

Now we have to configure the IP address and default gateway for this interface. Edit the network configuration by stopping the appliance, right-click on it's symbol and select "Edit config". Afterwards restart the appliance.

Now check the connectivity with ping. If you setup the cloud connection correctly, you should be able to ping the IP address of Ostinato appliance. Then start the Ostinato GUI on your system and create a new port group. Use the Ostinato appliance IP as it's IP address. Now you can control the Ostinato drone within the appliance by the GUI running on your local machine.