.nh
.TH umoci-raw-unpack(1) # umoci raw unpack - Unpacks an OCI image tag into a root filesystem
Aleksa Sarai
SEPTEMBER 2018

.SH NAME
.PP
umoci raw unpack - Unpacks an OCI image tag into a root filesystem


.SH SYNOPSIS
.PP
\fBumoci raw unpack\fP
[\fIumoci-unpack(1) flags\fP]
\fIrootfs\fP


.SH DESCRIPTION
.PP
Extracts all of the layers (deterministically) to a root filesystem at path
\fIrootfs\fP\&. This path \fImust not\fP already exist.


.SH OPTIONS
.PP
The global options are defined in \fBumoci\fP(1), while the options for this
particular subcommand are identical to \fBumoci-unpack\fP(1) with the exception
that the \fIrootfs\fP path is provided rather than a \fIbundle\fP path.


.SH EXAMPLE
.PP
The following downloads an image from a \fBdocker\fP(1) registry using
\fBskopeo\fP(1), unpacks said image to a root filesystem, generates an OCI
runtime configuration file with \fBumoci-raw-runtime-config\fP(1) and then
creates a new container with \fBrunc\fP(8).

.PP
.RS

.nf
% skopeo copy docker://opensuse/amd64:42.2 oci:image:latest
# umoci raw unpack --image image rootfs
# umoci raw runtime-config --image image --rootfs rootfs config.json
# runc run ctr
[ container session ]

.fi
.RE

.PP
With \fB--rootless\fP it is also possible to do the above example without root
privileges. \fBumoci\fP will generate a configuration that works with rootless
containers in \fBrunc\fP(8).

.PP
.RS

.nf
% skopeo copy docker://opensuse/amd64:42.2 oci:image:latest
% umoci raw unpack --image image --rootless rootfs
% umoci raw runtime-config --image image --rootfs rootfs --rootless config.json
% runc --root $HOME/runc run ctr
[ rootless container session ]

.fi
.RE


.SH SEE ALSO
.PP
\fBumoci\fP(1), \fBumoci-raw-runtime-config\fP(1), \fBrunc\fP(8)