Your company here — click to reach over 10,000 unique daily visitors

lxc-ls - Man Page

list the containers existing on the system


lxc-ls [-1] [--active] [--frozen] [--running] [--stopped] [--defined] [-f] [-F format] [-g groups] [--nesting=NUM] [--filter=regex]


lxc-ls list the containers existing on the system.



Show one entry per line. (default when /dev/stdout isn't a tty)


List only active containers (same as --frozen --running).


List only frozen containers.


List only running containers.


List only stopped containers.


List only defined containers.


Use a fancy, column-based output.

-F,--fancy-format format

Comma separated list of columns to show in the fancy output. The list of accepted and default fields is listed in --help.

-g,--groups groups

Comma separated list of groups the container must have to be displayed. The parameter may be passed multiple times.


Show nested containers. The number of nesting levels to be shown can be specified by passing a number as argument.


The regular expression passed to lxc-ls will be applied to the container name. The format is a POSIX extended regular expression. It can also be given as additional argument without explicitly using --filter.


lxc-ls --fancy

list all the containers, listing one per line along with its name, state, ipv4 and ipv6 addresses.

lxc-ls --active -1

list active containers and display the list in one column.

Common Options

These options are common to most of lxc commands.

-?,  -h,  --help

Print a longer usage message than normal.


Give the usage message

-q,  --quiet

mute on

-P,  --lxcpath=PATH

Use an alternate container path. The default is /var/lib/lxc.

-o,  --logfile=FILE

Output to an alternate log FILE. The default is no log.

-l,  --logpriority=LEVEL

Set log priority to LEVEL. The default log priority is ERROR. Possible values are : FATAL, ALERT, CRIT, WARN, ERROR, NOTICE, INFO, DEBUG, TRACE.

Note that this option is setting the priority of the events log in the alternate log file. It do not have effect on the ERROR events log on stderr.

-n,  --name=NAME

Use container identifier NAME. The container identifier format is an alphanumeric string.


Specify the configuration file to configure the virtualization and isolation functionalities for the container.

This configuration file if present will be used even if there is already a configuration file present in the previously created container (via lxc-create).


Show the version number.

See Also

lxc(7), lxc-create(1), lxc-copy(1), lxc-destroy(1), lxc-start(1), lxc-stop(1), lxc-execute(1), lxc-console(1), lxc-monitor(1), lxc-wait(1), lxc-cgroup(1), lxc-ls(1), lxc-info(1), lxc-freeze(1), lxc-unfreeze(1), lxc-attach(1), lxc.conf(5)


Written originally as a shell script by Daniel Lezcano and Serge Hallyn. Later reimplemented and extended in Python by Stéphane Graber and then reimplemented and extended in C by Christian Brauner.


Christian Brauner <christian.brauner@mailbox.org>, Stéphane Graber <stgraber@ubuntu.com>

Referenced By

lxc(7), lxc-attach(1), lxc-autostart(1), lxc-cgroup(1), lxc-checkconfig(1), lxc-checkpoint(1), lxc-config(1), lxc-console(1), lxc.container.conf(5), lxc-copy(1), lxc-create(1), lxc-destroy(1), lxc-device(1), lxc-execute(1), lxc-freeze(1), lxc-info(1), lxc-monitor(1), lxc-snapshot(1), lxc-start(1), lxc-stop(1), lxc.system.conf(5), lxc-top(1), lxc-unfreeze(1), lxc-unshare(1), lxc-update-config(1), lxc-usernsexec(1), lxc-wait(1).