https://github.com/project-stacker/stacker

A vendor-neutral OCI-native container image (tgz, squashfs, erofs) builder (purely based on OCI Image Specification)
https://github.com/project-stacker/stacker

Last synced: 2 months ago
JSON representation

A vendor-neutral OCI-native container image (tgz, squashfs, erofs) builder (purely based on OCI Image Specification)

• Host: GitHub
• URL: https://github.com/project-stacker/stacker
• Owner: project-stacker
• License: apache-2.0
• Created: 2017-11-30T16:32:26.000Z (over 8 years ago)
• Default Branch: main
• Last Pushed: 2026-03-20T18:08:00.000Z (3 months ago)
• Last Synced: 2026-03-21T06:46:33.930Z (3 months ago)
• Language: Go
• Homepage: https://stackerbuild.io
• Size: 19.5 MB
• Stars: 322
• Watchers: 5
• Forks: 39
• Open Issues: 113
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: CODEOWNERS
  • Security: SECURITY.md
  • Maintainers: MAINTAINERS.md

Awesome Lists containing this project

README

          



    



# stacker [![ci](https://github.com/project-stacker/stacker/actions/workflows/ci.yaml/badge.svg)](https://github.com/project-stacker/stacker/actions/workflows/ci.yaml) [![codecov](https://codecov.io/github/project-stacker/stacker/graph/badge.svg?token=uBy8C0fUbL)](https://codecov.io/github/project-stacker/stacker) [![CodeQL](https://github.com/project-stacker/stacker/workflows/CodeQL/badge.svg)](https://github.com/project-stacker/stacker/actions?query=workflow%3ACodeQL) [![Go Reference](https://pkg.go.dev/badge/stackerbuild.io/stacker.svg)](https://pkg.go.dev/stackerbuild.io/stacker) [![nightly](https://github.com/project-stacker/stacker/actions/workflows/nightly.yaml/badge.svg)](https://github.com/project-stacker/stacker/actions/workflows/nightly.yaml)

Stacker is a tool for building OCI images natively via a declarative yaml format.

## Features

* Single binary

* Rootless builds

* Hermetically sealed builds using LXC containers

* Also available as a [GitHub action](https://github.com/project-stacker/stacker-build-push-action)

### Installation

Stacker has various [build](doc/install.md) and [runtime](doc/running.md)

dependencies.

### Hacking

See the [hacking](doc/hacking.md) guide for tips on hacking/debugging stacker.

### Usage

See the [tutorial](doc/tutorial.md) for a short introduction to how to use stacker.

See the [`stacker.yaml` specification](doc/stacker_yaml.md) for full details on

the `stacker.yaml` specification.

Additionally, there are some [tips and tricks](doc/tricks.md) for common usage.

### TODO / Roadmap

* Upstream something to containers/image that allows for automatic detection

  of compression

* Design/implement OCIv2 drafts + final spec when it comes out

### Conference Talks

* An Operator Centric Way to Update Application Containers FOSDEM 2019

  * [video](https://archive.fosdem.org/2019/schedule/event/containers_atomfs/)

  * [slides](doc/talks/FOSDEM_2019.pdf)

* Building OCI Images without Privilege OSS EU 2018

  * [slides](doc/talks/OSS_EU_2018.pdf)

* Building OCI Images without Privilege OSS NA 2018

  * [slides](doc/talks/OSS_NA_2018.pdf)

(Note that despite the similarity in name of the 2018 talks, the content is

mostly disjoint; I need to be more creative with naming.)

### License

`stacker` is released under the [Apache License, Version 2.0](LICENSE), and is:

Copyright (C) 2017-2022 Cisco Systems, Inc. and contributors