www.LinuxHowtos.org

runc

Section: Misc. Reference Manual Pages (8)
Index Return to Main Contents

NAME

runc - Open Container Initiative runtime

SYNOPSIS

runc [globa-option ...] command [comman-option ...] [argument ...]

DESCRIPTION

runc is a command line client for running applications packaged according to the Open Container Initiative (OCI) format and is a compliant implementation of the Open Container Initiative specification.

runc integrates well with existing process supervisors to provide a production container runtime environment for applications. It can be used with your existing process monitoring tools and the container will be spawned as a direct child of the process supervisor.

Containers are configured using bundles. A bundle for a container is a directory that includes a specification file named config.json and a root filesystem. The root filesystem contains the contents of the container.

To run a new instance of a container:

# runc run [-b bundle ] containe-id

Where containe-id is your name for the instance of the container that you are starting. The name you provide for the container instance must be unique on your host.

Providing the bundle directory using -b is optional. The default value for bundle is the current directory.

COMMANDS

checkpoint

Checkpoint a running container. See run-checkpoint(8).

create

Create a container. See run-create(8).

delete

Delete any resources held by the container; often used with detached containers. See run-delete(8).

events

Display container events, such as OOM notifications, CPU, memory, I/O and network statistics. See run-events(8).

exec

Execute a new process inside the container. See run-exec(8).

kill

Send a specified signal to the container's init process. See run-kill(8).

list

List containers started by runc with the given -root. See run-list(8).

pause

Suspend all processes inside the container. See run-pause(8).

ps

Show processes running inside the container. See run-ps(8).

restore

Restore a container from a previous checkpoint. See run-restore(8).

resume

Resume all processes that have been previously paused. See run-resume(8).

run

Create and start a container. See run-run(8).

spec

Create a new specification file (config.json). See run-spec(8).

start

Start a container previously created by runc create. See run-start(8).

state

Show the container state. See run-state(8).

update

Update container resource constraints. See run-update(8).

help, h

Show a list of commands or help for a particular command.

GLOBAL OPTIONS

These options can be used with any command, and must precede the command.

-debug

Enable debug logging.

-log path

Set the log destination to path. The default is to log to stderr.

-lo-format text|json

Set the log format (default is text).

-root path

Set the root directory to store containers' state. The path should be located on tmpfs. Default is /run/runc, or $XDG_RUNTIME_DIR/runc for rootless containers.

-system-cgroup

Enable systemd cgroup support. If this is set, the container spec (config.json) is expected to have cgroupsPath value in the slice:prefix:name form (e.g. system.slice:runc:434234).

-rootless true|false|auto

Enable or disable rootless mode. Default is auto, meaning to aut-detect whether rootless should be enabled.

-help|-h

Show help.

-version|-v

Show version.