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


kathara-list - Show all running Kathara devices of the current user


kathara list [-h] [-a] [-w] [-n DEVICE_NAME]


Display a variety of information for all the running devices of the current user.

The following information are displayed:


-h, --help
Show a help message and exit.
-a, --all
Show information of running Kathara devices of all users. MUST BE ROOT FOR THIS OPTION.

This option can be run only by root users.

-w, -l, --watch, --live
Watch updates of devices' status.

To quit the live screen, pass the SIGINT signal(7) to the process (usually CTRL+C).

Show only information about a specified device.

Show information about a device DEVICE_NAME.


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.



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