1. kathara-lstart(1)
  2. Kathara manual
  3. kathara-lstart(1)


kathara-lstart - Start a Kathara network scenario


kathara lstart [-h] [--noterminals | --terminals | --privileged]
[-d DIRECTORY] [-F] [-l] [-o [OPTION [OPTION ...]]] [--xterm XTERM]
[--print] [--no-hosthome | --hosthome] [--no-shared | --shared] [--exclude DEVICE_NAME [DEVICE_NAME ...]]


In order to ease setting up complex network with Kathara it is possible to completely describe it into special configuration files, creating a so-called network scenario. The network scenario can be started with a single command as if it were a virtual network 'laboratory'.

Start a set of devices that are part of a Kathara network scenario and configures them according to the parameters contained in the network scenario description. By default, all the devices that make up the network scenario are started. If a list of DEVICE_NAMEs is provided, then only devices with a matching name and that are part of the network scenario are started.

The configuration of a Kathara network scenario consists of some files described in kathara-lab.conf(5), kathara-lab.dep(5), kathara-lab.ext(5) and directories whose names, locations and contents are described in kathara-lab-dirs(7).

kathara-lab.ext(5) is only available on Linux platforms and need root permissions to be used. In addition, terminals are not open automatically when this file is present. To connect to a device, use kathara-connect(1).



Report bugs opening an issue on the official GitHub repository where the development and maintenance is primarily done.
Issues which are security relevant should be disclosed privately to the Kathara mailing list. You do not have to be subscribed to the list to send a message there.
When reporting a bug, remember to write used commands, eventually attach your network scenario, and include the output of kathara-check(1) in order to make possible to reproduce the bug.


Kathara was born from Netkit. Its first version was developed by Gaetano Bonofiglio and Veronica Iovinella. Currently it is mantained by Mariano Scazzariello, Tommaso Caiazzi and Lorenzo Ariemma.

People involved also include:

Copyright © 2017-2024 License GPLv3+: GNU GPL version 3 or later http://gnu.org/licenses/gpl.html. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.


kathara(1), kathara-lclean(1), kathara-lrestart(1), kathara-ltest(1), kathara-linfo(1), kathara-lab.conf(5), kathara-lab.dep(5), kathara-lab.ext(5)

  1. July 2024
  2. kathara-lstart(1)