Distribution API

This specification defines the artifact format, delivery mechanism, and order resolution process for buildpacks.

Buildpack Descriptor

A buildpack must contain a buildpack.toml file in its root directory.


A buildpackage is a distributable artifact that contains a buildpack. Its format may be either:

  • An OCI image
  • An uncompressed tar archive with the extension .cnb containing an OCI image.

Further Reading

You can read the complete Distribution specification on Github.