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

.SH "نام (NAME)"
umoci raw unpack \- Unpacks an OCI image tag into a root filesystem


.SH "خلاصه دستور (SYNOPSIS)"
\fBumoci raw unpack\fP
[\fIumoci-unpack(1) flags\fP]
\fIrootfs\fP


.SH "توضیحات (DESCRIPTION)"
Extracts all of the layers (deterministically) to a root filesystem at path
\fIrootfs\fP\&. This path \fImust not\fP already exist.


.SH "گزینه‌ها (OPTIONS)"
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)"
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).

.EX
% 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 ]
.EE

.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).

.EX
% 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 ]
.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBumoci\fP(1), \fBumoci-raw-runtime-config\fP(1), \fBrunc\fP(8)