1lxc-start(1) lxc-start(1)
2
3
4
6 lxc-start - run an application inside a container.
7
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
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
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
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
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
127 lxc(7), lxc-create(1), lxc-copy(1), lxc-destroy(1), lxc-start(1), lxc-
128 stop(1), lxc-execute(1), lxc-console(1), lxc-monitor(1), lxc-wait(1),
129 lxc-cgroup(1), lxc-ls(1), lxc-info(1), lxc-freeze(1), lxc-unfreeze(1),
130 lxc-attach(1), lxc.conf(5)
131
133 Daniel Lezcano <daniel.lezcano@free.fr>
134
135
136
137 2020-01-29 lxc-start(1)