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


kathara-exec - Execute a command in a Kathara device


kathara exec [-h] [-d DIRECTORY | -v]
[--no-stdout] [--no-stderr] [--wait]


Execute a command in the Kathara device DEVICE_NAME.


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

Execute the specified command in 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 --vmachine.

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

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

Disable stdout of the executed command.
Disable stderr of the executed command.
Wait until startup commands execution finishes.

You can override the wait by pressing [ENTER].

Name of the device to execute the command into.
Shell command that will be executed inside the device.


kathara exec -v pc1 -- ping

Execute the command ping into a device called pc1, started with kathara-vstart(1).

kathara exec as1r1 "ping"

Execute the command ping into 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-exec(1)