lxc-start(1)

NAME

lxc-start - run an application inside a container.

SYNOPSIS

lxc-start {-n name} [-f config_file] [-c console_device] [-L console_logfile] [-d] [-F] [-p pid_file] [-s KEY=VAL] [-C] [--share-[net|ipc|uts] name|pid] [command]

DESCRIPTION

lxc-start runs the specified command inside the container specified by name.

It will setup the container according to the configuration previously defined with the lxc-create command or with the configuration file parameter. If no configuration is defined, the default isolation is used.

If no command is specified, lxc-start will use the command defined in lxc.init.cmd or if not set, the default "/sbin/init" command to run a system container.

OPTIONS

FC-d, --daemonF[0]: Run the container as a daemon. As the container has no more tty, if an error occurs nothing will be displayed, the log file can be used to check the error. (This is the default mode)

FC-F, --foregroundF[0]: Run the container in the foreground. In this mode, the container console will be attached to the current tty and signals will be routed directly to the container.

FC-p, --pidfile F[0]pid_file: Create a file with the process id.

FC-f, --rcfile F[0]config_file

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).

FC-c, --console F[0]console_device: Specify a device to use for the container's console, for example /dev/tty8. If this option is not specified the current terminal will be used unless FC-dF[0] is specified.

FC-L, --console-log F[0]console_logfile: Specify a file to log the container's console output to.

FC-s, --define F[0]KEY=VAL: Assign value VAL to configuration variable KEY. This overrides any assignment done in config_file.

FC-C, --close-all-fdsF[0]: If any file descriptors are inherited, close them. If this option is not specified, then lxc-start will exit with failure instead. Note: --daemon implies --close-all-fds.

FC--share-net F[0]name|pid: Inherit a network namespace from a name container or a pid. The network namespace will continue to be managed by the original owner. The network configuration of the starting container is ignored and the up/down scripts won't be executed.

FC--share-ipc F[0]name|pid: Inherit an IPC namespace from a name container or a pid.

FC--share-uts F[0]name|pid: Inherit a UTS namespace from a name container or a pid. The starting LXC will not set the hostname, but the container OS may do it anyway.

COMMON OPTIONS

These options are common to most of lxc commands.

FC-?, -h, --helpF[0]: Print a longer usage message than normal.

FC--usageF[0]: Give the usage message

FC-q, --quietF[0]: mute on

FC-P, --lxcpath=F[0]PATH: Use an alternate container path. The default is /var/lib/lxc.

FC-o, --logfile=F[0]FILE: Output to an alternate log FILE. The default is no log.

FC-l, --logpriority=F[0]LEVEL

Set log priority to LEVEL. The default log priority is FCERRORF[0]. Possible values are : FCFATALF[0], FCALERTF[0], FCCRITF[0], FCWARNF[0], FCERRORF[0], FCNOTICEF[0], FCINFOF[0], FCDEBUGF[0], FCTRACEF[0].

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.

FC-n, --name=F[0]NAME: Use container identifier NAME. The container identifier format is an alphanumeric string.

FC--rcfile=F[0]FILE