Platform API

This specification defines the interface between the buildpack execution environment, referred to as the lifecycle, and a platform that supports it. This API is used by platform implementors.


A stack defines two OCI images: a build image and a run image. The build image is used to run the buildpack lifecycle, and the run image is the base image the final exported image will be built upon.

For more information see Working with stacks.


Buildpacks are stored on the filesystem as unarchived files such that:

  • Each top-level directory is a buildpack ID.
  • Each second-level directory is a buildpack version.


For security reasons, images built with platforms, such as pack, build and run as non-root users.

Further Reading

You can read the complete Platform API specification on Github.