User Manual


Topologies are the basic entities in ToMaTo. A topology represents a complete network topology including end-host devices, routers and switches, and connections between them.

As long as you have not explicitly connected elements to the Internet, there is no network connection between any element and the Internet.

You can create multiple topologies, each of which will be separated from each other. Usually, you will create one topology per experiment.


To see a list of available topologies, click on “My Topologies” in the main menu. → go now

In the list of available topologies, you can select an existing topology, or create a new one. When doing so, the topology editor will open, providing you with full control over the topology.


Topologies can be shared between multiple users. Read more about this here.


Topologies time out after a while. This avoids old topologies from being forgotten and never stopped. In order to use your topologies for a long time, you must renew them regularly. This can be done in the editor via the Renew button in the Topology tab.

When the topology reaches its timeout, all elements will be stopped. A long time after the timeout, the elements will be destroyed. Some time after the destruction, the topology will be removed.


ToMaTo provides tutorials for new users. These tutorials can also be accessed from the topology list page. → go now

It is possible to load third-party tutorials which can also be used for educational purposes. Consult the advanced user’s manual to learn how to write your own tutorials.

Export and Import

You can export your topology design to a file by clicking on the Export button in the editor’s Topology tab. This will export only the data that would be left in the created state, i.e., what is left after destruction.

You can import the exported file on the topology list page.


You can remove the topology via the editor by clicking on the Delete button in the Topology tab.

Removing a topology will destroy all elements of this topology, hence removing all respective data belonging to these elements from the system!