lxc-start-ephemeral(1)

lxc-start-ephemeral1

Start an ephemeral copy of an existing container

Usage

lxc-start-ephemeral [-o] [-n] [-d] [--bdir] [--user] [--key] [--union-type] [--keep-data] [COMMAND]

Overview

lxc-start-ephemeral start an ephemeral copy of an existing container.

Options

FC-oF[0]

Original container name

FC[-n]F[0]

Name of the ephemeral container (defaults to a random suffix).

FC[-d]F[0]

Start the container in background and print the name and IP. This option can't be used if a command is passed.

FC[--bdir]F[0]

Directory to bind mount into container. Can be passed multiple times.

FC[--user]F[0]

The user to connect to the container as. Used when passing a command to lxc-start-ephemeral.

FC[--key]F[0]

Copy the provided SSH public key into the container.

FC[--union-type]F[0]

Force a specific union file system. Can be one of: overlayfs aufs

FC[--keep-data]F[0]

Use a persistent backend instead of tmpfs. With this option, you can lxc-stop and lxc-start the no longer so ephemeral container (it's still an overlay, but a persistent one).

FC[COMMAND]F[0]

Immediately run the provided command in the container. This currently uses ssh (not attach) and is incompatible with daemon mode.

Examples

lxc-start-ephemeral -o p1

Simply start an ephemeral container and attach to the console. This container will be based on existing container "p1".

lxc-start-ephemeral -o p1 -n p1-ephemeral -d

Start an ephemeral container based on p1 called p1-ephemeral and print its IP and name to the console instead of attaching.

Author

Stéphane Graber <[email protected][0]>

From lxc 1:1.0.6-6+deb8u6 in Debian 8 (Jessie). Parsed by carta from the page's man source.