OS Manuals

/usr/bin/jailer

process-isolation jailer for firecracker

From firecracker-jailer 1.18.0-r0 (enterprise-packages), captured 2026-11-08 by running jailer --help (exit 0). permalink

Jailer v1.18.0

required arguments:
  --exec-file <exec-file>   File path to exec into.
  --gid <gid>               The group identifier the jailer switches to after exec.
  --id <id>                 Jail ID.
  --uid <uid>               The user identifier the jailer switches to after exec.

optional arguments:
  --cgroup <cgroup>                     Cgroup and value to be set by the jailer. It must follow this format: <cgroup_file>=<value> (e.g cpu.shares=10). This argument can be used multiple times to add multiple cgroups.
  --cgroup-version <cgroup-version>     Select the cgroup version used by the jailer. [default: "1"]
  --chroot-base-dir <chroot-base-dir>   The base folder where chroot jails are located. [default: "/srv/jailer"]
  --daemonize                           Daemonize the jailer before exec, by invoking setsid(), and redirecting the standard I/O file descriptors to /dev/null.
  --help                                Show the help message.
  --netns <netns>                       Path to the network namespace this microVM should join.
  --new-pid-ns                          Exec into a new PID namespace.
  --parent-cgroup <parent-cgroup>       Parent cgroup in which the cgroup of this microvm will be placed.
  --resource-limit <resource-limit>     Resource limit values to be set by the jailer. It must follow this format: <resource>=<value> (e.g no-file=1024). This argument can be used multiple times to add multiple resource limits. Current available resource values are:
		fsize: The maximum size in bytes for files created by the process.
		no-file: Specifies a value one greater than the maximum file descriptor number that can be opened by this process.
  --version                             Print the binary version number.

Any arguments after the -- separator will be supplied to the jailed binary.
Options (14)
OptionDescriptionSource
--exec-file exec-fileFile path to exec into.help
--gid gidThe group identifier the jailer switches to after exec.help
--id idJail ID.help
--uid uidThe user identifier the jailer switches to after exec.help
--cgroup cgroupCgroup and value to be set by the jailer.help
--cgroup-version cgroup-versionSelect the cgroup version used by the jailer.help
--chroot-base-dir chroot-base-dirThe base folder where chroot jails are located.help
--daemonizeDaemonize the jailer before exec, by invoking setsid(), and redirecting the standard I/O file descriptors to /dev/null.help
--helpShow the help message.help
--netns netnsPath to the network namespace this microVM should join.help
--new-pid-nsExec into a new PID namespace.help
--parent-cgroup parent-cgroupParent cgroup in which the cgroup of this microvm will be placed.help
--resource-limit resource-limitResource limit values to be set by the jailer.help
--versionPrint the binary version number.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.