lxc-start(1)

1lxc-start(1)                                                      lxc-start(1)
2
3
4

NAME

6       lxc-start - run an application inside a container.
7

SYNOPSIS

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

DESCRIPTION

14       lxc-start  runs the specified command inside the container specified by
15       name.
16
17       It will setup the container according to the  configuration  previously
18       defined  with the lxc-create command or with the configuration file pa‐
19       rameter.  If no configuration is  defined,  the  default  isolation  is
20       used.
21
22       If  no  command is specified, lxc-start will use the command defined in
23       lxc.init.cmd or if not set, the default "/sbin/init" command to  run  a
24       system container.
25

OPTIONS

27       -d, --daemon
28              Run the container as a daemon. As the container has no more tty,
29              if an error occurs nothing will be displayed, the log  file  can
30              be used to check the error. (This is the default mode)
31
32       -F, --foreground
33              Run the container in the foreground. In this mode, the container
34              console will be attached to the current tty and signals will  be
35              routed directly to the container.
36
37       -p, --pidfile pid_file
38              Create a file with the process id.
39
40       -f, --rcfile config_file
41              Specify  the  configuration file to configure the virtualization
42              and isolation functionalities for the container.
43
44              This configuration file if present will be used even if there is
45              already  a  configuration file present in the previously created
46              container (via lxc-create).
47
48       -c, --console console_device
49              Specify a device to use for the container's console, for example
50              /dev/tty8.  If this option is not specified the current terminal
51              will be used unless -d is specified.
52
53       -L, --console-log console_logfile
54              Specify a file to log the container's console output to.
55
56       -s, --define KEY=VAL
57              Assign value VAL to configuration variable KEY.  This  overrides
58              any assignment done in config_file.
59
60       -C, --close-all-fds
61              If  any  file descriptors are inherited, close them. If this op‐
62              tion is not specified, then lxc-start will exit with failure in‐
63              stead. Note: --daemon implies --close-all-fds.
64
65       --share-net name|pid
66              Inherit  a network namespace from a name container or a pid. The
67              network namespace will continue to be managed  by  the  original
68              owner.  The  network  configuration of the starting container is
69              ignored and the up/down scripts won't be executed.
70
71       --share-ipc name|pid
72              Inherit an IPC namespace from a name container or a pid.
73
74       --share-uts name|pid
75              Inherit a UTS namespace from a name  container  or  a  pid.  The
76              starting LXC will not set the hostname, but the container OS may
77              do it anyway.
78

COMMON OPTIONS

80       These options are common to most of lxc commands.
81
82       -?, -h, --help
83              Print a longer usage message than normal.
84
85       --usage
86              Give the usage message
87
88       -q, --quiet
89              mute on
90
91       -P, --lxcpath=PATH
92              Use an alternate container path. The default is /var/lib/lxc.
93
94       -o, --logfile=FILE
95              Output to an alternate log FILE. The default is no log.
96
97       -l, --logpriority=LEVEL
98              Set log priority to LEVEL. The default log  priority  is  ERROR.
99              Possible  values  are  : FATAL, CRIT, WARN, ERROR, NOTICE, INFO,
100              DEBUG.
101
102              Note that this option is setting the priority of the events  log
103              in  the  alternate  log file. It do not have effect on the ERROR
104              events log on stderr.
105
106       -n, --name=NAME
107              Use container identifier NAME.  The container identifier  format
108              is an alphanumeric string.
109
110       --rcfile=FILE
111              Specify  the  configuration file to configure the virtualization
112              and isolation functionalities for the container.
113
114              This configuration file if present will be used even if there is
115              already  a  configuration file present in the previously created
116              container (via lxc-create).
117
118       --version
119              Show the version number.
120

DIAGNOSTIC

122       The container is busy
123              The specified container is already running an  application.  You
124              should stop it before reuse this container or create a new one.
125

AUTHOR

133       Daniel Lezcano <daniel.lezcano@free.fr>
134
135
136
137                                  2019-09-09                      lxc-start(1)