.nh
.TH buildah-mount "1" "March 2017" "buildah"
.SH NAME
.PP
buildah-mount - Mount a working container's root filesystem.

.SH SYNOPSIS
.PP
\fBbuildah mount\fP [\fIcontainer\fP ...]

.SH DESCRIPTION
.PP
Mounts the specified container's root file system in a location which can be
accessed from the host, and returns its location.

.PP
If the mount command is invoked without any arguments, the tool will list all of the currently mounted containers.

.PP
When running in rootless mode, mount runs in a different namespace so
that the mounted volume might not be accessible from the host when
using a driver different than \fBvfs\fR\&.  To be able to access the file
system mounted, you might need to create the mount namespace
separately as part of \fBbuildah unshare\fR\&.  In the environment created
with \fBbuildah unshare\fR you can then use \fBbuildah mount\fR and have
access to the mounted file system.

.SH RETURN VALUE
.PP
The location of the mounted file system.  On error an empty string and errno is
returned.

.SH OPTIONS
.PP
\fB--json\fP

.PP
Output in JSON format.

.SH EXAMPLE
.EX
buildah mount working-container
/var/lib/containers/storage/overlay2/f3ac502d97b5681989dff84dfedc8354239bcecbdc2692f9a639f4e080a02364/merged
.EE

.EX
buildah mount
working-container /var/lib/containers/storage/overlay2/f3ac502d97b5681989dff84dfedc8354239bcecbdc2692f9a639f4e080a02364/merged
fedora-working-container /var/lib/containers/storage/overlay2/0ff7d7ca68bed1ace424f9df154d2dd7b5a125c19d887f17653cbcd5b6e30ba1/merged
.EE

.EX
buildah mount working-container fedora-working-container ubi8-working-container
working-container /var/lib/containers/storage/overlay/f8cac5cce73e5102ab321cc5b57c0824035b5cb82b6822e3c86ebaff69fefa9c/merged
fedora-working-container /var/lib/containers/storage/overlay/c3ec418be5bda5b72dca74c4d397e05829fe62ecd577dd7518b5f7fc1ca5f491/merged
ubi8-working-container /var/lib/containers/storage/overlay/03a071f206f70f4fcae5379bd5126be86b5352dc2a0c3449cd6fca01b77ea868/merged
.EE

.PP
If running in rootless mode, you need to do a buildah unshare first to use
the mount point.

.EX
$ buildah unshare
# buildah mount working-container
/var/lib/containers/storage/overlay/f8cac5cce73e5102ab321cc5b57c0824035b5cb82b6822e3c86ebaff69fefa9c/merged
# cp foobar  /var/lib/containers/storage/overlay/f8cac5cce73e5102ab321cc5b57c0824035b5cb82b6822e3c86ebaff69fefa9c/merged
# buildah unmount working-container
# exit
$ buildah commit  working-container newimage
.EE

.SH SEE ALSO
.PP
buildah(1), buildah-unshare(1), buildah-umount(1)