Go Shell Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.site contrib: logo: initial commit of logo Aug 13, 2018
cmd/umoci hack: remove pkg/errors patch Aug 2, 2018
contrib contrib: logo: initial commit of logo Aug 13, 2018
doc contrib: logo: initial commit of logo Aug 13, 2018
hack contrib: logo: initial commit of logo Aug 13, 2018
mutate *: switch from "compress/gzip" to more optimal library Aug 3, 2018
oci *: switch from "compress/gzip" to more optimal library Aug 3, 2018
pkg pkg: unpriv: add Walk implementation Mar 9, 2018
test cmd: implement "raw unpack" Jun 18, 2018
third_party third_party: shared: import github.com/lxc/lxd/shared@lxd-2.21 Mar 9, 2018
vendor *: switch from "compress/gzip" to more optimal library Aug 3, 2018
.gitignore *: move to openSUSE Feb 6, 2017
.gitmodules .site: bare hugo site with theme [ci skip] Oct 25, 2017
.lgtm lgtm: approval -> approvals [ci skip] Dec 17, 2016
.travis.yml ci: small fixes Oct 25, 2017
CHANGELOG.md VERSION: release v0.4.1 Aug 16, 2018
CONTRIBUTING.md CONTRIBUTING: add missing reference link Oct 19, 2017
COPYING readme: add information about in progress points Nov 4, 2016
Dockerfile test: add tests for user.rootlesscontainers Mar 3, 2018
MAINTAINERS MAINTAINERS: add maintainers file Nov 11, 2016
Makefile vendor: switch to vndr for vendoring Aug 2, 2018
README.md contrib: logo: initial commit of logo Aug 13, 2018
VERSION VERSION: back to development Aug 16, 2018
packaging packaging: move to contrib/pkg Mar 21, 2017
vendor.conf *: switch from "compress/gzip" to more optimal library Aug 3, 2018



Release Build Status License: Apache 2.0

Go Report Card CII Best Practices DOI

umoci modifies Open Container images. See the official website for more accessible documentation about how to use umoci.

umoci intends to be a complete manipulation tool for OCI images. In particular, it should be seen as a more end-user-focused version of the oci-image-tools provided by the OCI. The hope is that all of this tooling will eventually be merged with the upstream repository, so that it is always kept up-to-date by the Open Container Initiative community.

However, currently there is a lot of discussion about the new tooling going into the OCI image tools, and right now I need tooling that can abstract all of the internals of the OCI specification into a single CLI interface. The main purpose of this tool is to serve as example of what I would like to see in an oci-image tool.

If you wish to provide feedback or contribute, read the CONTRIBUTING.md for this project to refresh your knowledge about how to submit good bug reports and patches. Information about how to submit responsible security disclosures is also provided.


We regularly publish new releases, with each release being given a unique identifying version number (as governed by Semantic Versioning (SemVer)). Information about previous releases including the list of new features, bug fixes and resolved security issues is available in the change log. You can get pre-built binaries and corresponding source code for each release from the releases page.


If you wish to build umoci from source, follow these steps to build in with golang.

go get -d github.com/openSUSE/umoci
cd $GOPATH/github.com/openSUSE/umoci
make install

Your umoci binary will be in $HOME/bin.


umoci has a subcommand-based command-line. For more detailed information, see the generated man pages (which you can build with make doc). You can also read through our quick start guide.

% umoci --help
   umoci - umoci modifies Open Container images

   umoci [global options] command [command options] [arguments...]


   Aleksa Sarai <asarai@suse.com>

     raw      advanced internal image tooling
     help, h  Shows a list of commands or help for one command

     config      modifies the image configuration of an OCI image
     unpack      unpacks a reference into an OCI runtime bundle
     repack      repacks an OCI runtime bundle into a reference
     new         creates a blank tagged OCI image
     tag         creates a new tag in an OCI image
     remove, rm  removes a tag from an OCI image
     stat        displays status information of an image manifest

     gc        garbage-collects an OCI image's blobs
     init      create a new OCI layout
     list, ls  lists the set of tags in an OCI image

   --verbose      alias for --log=info
   --log value    set the log level (debug, info, [warn], error, fatal) (default: "warn")
   --help, -h     show help
   --version, -v  print the version


umoci is licensed under the terms of the Apache 2.0 license.

umoci: Umoci Modifies Open Containers' Images
Copyright (C) 2016, 2017, 2018 SUSE LLC.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at


Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.


If you have used umoci in your research, please cite it like you would any other useful software. Here is a handy BibTex citation.

	title = {umoci - Standalone Tool For Manipulating Container Images},
	author = {Aleksa Sarai et al.},
	year = {2016},
	url = {https://umo.ci/},
	doi = {http://dx.doi.org/10.5281/zenodo.1188474},

Thank you.