0.12.0

apple/container0.12.0Apr 27, 2026by github-actions[bot]

AI Summary

This release introduces progress output modes (plain/color), YAML output support, and --cap-add/--cap-drop capabilities, while updating the kernel and fixing build errors.

Key Highlights

  • Adds progress output modes (plain, color) and YAML support.
  • Adds --cap-add and --cap-drop support for containers.
  • Updates kernel to kata-3.28.0.
  • Fixes ARG parsing bugs and build archive errors.

Breaking Changes

  • Support --cap-add and --cap-drop for containers. The default set of capabilities has been reduced
  • Fix errors with Dockerfile-specific ignore file and read-only build context (gRPC protocol change)

New Features

  • Progress output modes
  • YAML output
  • Capabilities support
  • Kernel update
  • ARG parsing fix

Full Release Notes

## Highlights 

āŒØļø denotes breaking CLI changes.

šŸ‘©ā€šŸ’» denotes breaking API changes.

- Core 
  - [`plain` progress output](https://github.com/apple/container/issues/1365)
  - [`color` progress output](https://github.com/apple/container/issues/1366)
  - [Use `plain` if stderr is not a TTY](https://github.com/apple/container/issues/113)
  - [Consolidated output format handling](https://github.com/apple/container/pull/1385)
  - [YAML output format support](https://github.com/apple/container/issues/1156)
  - āŒØļø [Support `--cap-add` and `--cap-drop` for containers](https://github.com/apple/container/issues/1260). The [default set of capabilities](https://github.com/apple/container/blob/main/docs/how-to.md#control-linux-capabilities) has been reduced, so if you need the old behavior that grants all capabilities, you will need to delete and recreate your containers.
  - [Use TOML for plugin configuration files](https://github.com/apple/container/discussions/1336)
  - [Pass `SSH_AUTH_SOCK` properly if its value changes after user login](https://github.com/apple/container/issues/357)
  - [Update kernel to kata-3.28.0](https://github.com/apple/container/pull/1431)
- Images 
  - [User-friendly platform error message for `image save`](https://github.com/apple/container/issues/874)
- Build
  - [Fix `unable to write data to the archive, code 0` error during build](https://github.com/apple/container/issues/1375)
  - šŸ‘©ā€šŸ’»[Fix errors with Dockerfile-specific ignore file and read-only build context](https://github.com/apple/container/pull/1343). This change modified the container-builder-shim gRPC protocol such that older clients cannot perform builds. Please file an issue if this adversely affects your project. We've going to attempt to keep the protocol compatible for subsequent major version 0 releases.
  - [Fix `ARG` parsing bugs](https://github.com/apple/container/issues/1295) 
- Storage
  - [Fix unreliable single file mounts](https://github.com/apple/container/issues/1251)
  - [Journal option for `container volume create`](https://github.com/apple/container/issues/1411)

## What's Changed
* Removes unused `Archiver.uncompress()`. by @jglogan in https://github.com/apple/container/pull/1372
* Relocate Source/Helpers folders to sensible locations. by @jglogan in https://github.com/apple/container/pull/1363
* ci: bump the github-actions group with 2 updates by @dependabot[bot] in https://github.com/apple/container/pull/1374
* Add Plain Progress Output Mode by @nrthakur in https://github.com/apple/container/pull/1367
* Adding Bug Report Guide by @ajemory in https://github.com/apple/container/pull/1292
* Fixing issue template help paths by @ajemory in https://github.com/apple/container/pull/1382
* doc: Document plain clear-on finish behavior by @manojmahapatra in https://github.com/apple/container/pull/1379
* Remove XPC timeout based on SIGTERM timeout in container stop by @katiewasnothere in https://github.com/apple/container/pull/1387
* Dedupe user-supplied IDs for container delete. by @jglogan in https://github.com/apple/container/pull/1388
* feat: add help for cli plugin by @tico88612 in https://github.com/apple/container/pull/1068
* Bump containerization to 0.30.1 by @adityaramani in https://github.com/apple/container/pull/1396
* Consolidate CLI formatting infrastructure by @realrajaryan in https://github.com/apple/container/pull/1385
* Move exit status check into ExitWaiter register call by @katiewasnothere in https://github.com/apple/container/pull/1397
* Create ResourceLabels and use for ManagedResource, NetworkConfiguration. by @jglogan in https://github.com/apple/container/pull/1360
* Add capabilities support by @dcantah in https://github.com/apple/container/pull/1383
* API: Rename to NetworkClient, client as instance. by @jglogan in https://github.com/apple/container/pull/1405
* Write file data into archive only for regular files by @adityaramani in https://github.com/apple/container/pull/1403
* Add Color Progress Output Mode by @nrthakur in https://github.com/apple/container/pull/1384
* Fall back to simple text output when stdout is not a TTY by @knQzx in https://github.com/apple/container/pull/1392
* Fix ContainerResource build failure by @DePasqualeOrg in https://github.com/apple/container/pull/1408
* ci: bump the github-actions group with 3 updates by @dependabot[bot] in https://github.com/apple/container/pull/1419
* Move to TOML configuration for plugin configurations by @noah-thor in https://github.com/apple/container/pull/1422
* Fix ssh forwarding to use current SSH_AUTH_SOCK value by @JaewonHur in https://github.com/apple/container/pull/1420
* Update builder API to use grpc-swift-2. (#1309) by @jglogan in https://github.com/apple/container/pull/1416
* stats: restore terminal when streaming is interrupted by a signal by @Otoru in https://github.com/apple/container/pull/1355
* improve error message when image save platform is not available by @knQzx in https://github.com/apple/container/pull/1418
* Fix using docker specific ignore with read-only build context by @JaewonHur in https://github.com/apple/container/pull/1349
* Update kernel to kata-3.28.0. by @jglogan in https://github.com/apple/container/pull/1431
* Makes bootstrap env parameter compatible with older clients. by @jglogan in https://github.com/apple/container/pull/1434
* Add unit and integration coverage report make targets by @noah-thor in https://github.com/apple/container/pull/1427
* [build]: add tests for copy from by @saehejkang in https://github.com/apple/container/pull/1380
* Explicitly pass default subnets into network creation by @noah-thor in https://github.com/apple/container/pull/1424
* Updates containerization dependency to 0.31.0. by @jglogan in https://github.com/apple/container/pull/1435
* Fix: memory leak and silent read error in Archiver._compressFile causing build failures under /Users/ by @Ronitsabhaya75 in https://github.com/apple/container/pull/1432
* Adds journal option to `container volume create`. by @jglogan in https://github.com/apple/container/pull/1412
* Create a NOTICE file for apple/container's dependencies by @katiewasnothere in https://github.com/apple/container/pull/1436
* Make `ProgressFlags.makeConfig()` public. by @jglogan in https://github.com/apple/container/pull/1438
* Change guest ssh socket path by @JaewonHur in https://github.com/apple/container/pull/1441
* Add container system version with format yaml by @tico88612 in https://github.com/apple/container/pull/1353
* add plugin label to builder by @realrajaryan in https://github.com/apple/container/pull/1443
* Add yams to apple/container's notice file by @katiewasnothere in https://github.com/apple/container/pull/1442
* Fix "not installing shadowed plugin" startup log noise. by @jglogan in https://github.com/apple/container/pull/1451

## New Contributors
* @nrthakur made their first contribution in https://github.com/apple/container/pull/1367
* @knQzx made their first contribution in https://github.com/apple/container/pull/1392
* @DePasqualeOrg made their first contribution in https://github.com/apple/container/pull/1408
* @noah-thor made their first contribution in https://github.com/apple/container/pull/1422

**Full Changelog**: https://github.com/apple/container/compare/0.11.0...0.12.0