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


kathara-connect - Connect to a Kathara device


kathara connect [-h] [-d DIRECTORY | -v]
[--shell SHELL] [-l]


Open a shell in device DEVICE_NAME.


-h, --help
Show a help message and exit.
Specify the folder containing the network scenario.

Connect to a Kathara device belonging to a network scenario that is located inside DIRECTORY.
If no -d option is provided, assume the network scenario is located in the current directory. This option cannot be used in conjuction with -v or --vdevice.

-v, --vdevice
The device has been started with vstart command.

This option cannot be used in conjuction with -d or --directory.

--command SHELL
Command that should be executed inside the device.

By default, the shell specified in kathara.conf(5) file is executed. This option overrides this setting.

-l, --logs
Print device startup logs before launching the shell.

By default it does not print the startup logs, this behaviour is not customizable by the user.

Name of the device to connect to.


kathara connect -v pc1

Connects to a device called pc1, started with kathara-vstart(1).

kathara connect as1r1

Connects to a device called as1r1 belonging to a network scenario located in current folder and started with kathara-lstart(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-vstart(1), kathara-lstart(1)

  1. February 2024
  2. kathara-connect(1)