0.8.0

apple/container0.8.0Jan 22, 2026by jglogan

AI Summary

This release addresses a security vulnerability (CVE-2026-20613) regarding image loading and fixes filesystem integrity errors. It introduces IPv6 network configuration, read-only root filesystem support, and reorganizes client APIs.

Key Highlights

  • Prevent `container image load` from writing files outside the extraction directory (Security Fix)
  • Fixed panics filesystem data integrity errors when stressing containers
  • `container system version` shows version info
  • `--read-only` command for container create/run mounts root filesystem read-only
  • Reorganized client APIs (Breaking API Change)

Breaking Changes

  • Reorganized client APIs

New Features

  • IPv6 network configuration and port forwarding
  • Volume filesystem performance improvements
  • Platform architecture aliases for amd64 and arm64
  • Support for aarch64 architecture alias

Full Release Notes

> [!IMPORTANT]
>
> This release addresses a low severity security issue ([CVE-2026-20613](https://github.com/apple/containerization/security/advisories/GHSA-cq3j-qj2h-6rv3)) in the containerization library whereby a poorly assembled or maliciously crafted image tar archive can write files to locations other than the extraction directory. The issue is present when a user runs the `container image load` command (or the `cctl image load command in containerization)
>
> No privilege escalation is possible by exploiting the issue; the archive extractor can only write files that the user could write themselves.

## Highlights

⌨️ denotes breaking CLI changes.

👩‍💻 denotes breaking API changes.

* Core
  * [Prevent `container image load` from writing files outside the extraction directory](https://github.com/apple/container/pull/1056)
  * [Fixed panics filesystem data integrity errors when stressing containers](https://github.com/apple/container/issues/614)
  * Numerous stability fixes for container start and stop.
  * [`container system version` shows version info](https://github.com/apple/container/issues/824)
  * [`--read-only command for container create/run mounts root filesystem read-only](https://github.com/apple/container/pull/999)
  * [Add platform architecture aliases for amd64 and arm64](https://github.com/apple/container/issues/1035)
  * 👩‍💻 [Reorganized client APIs](https://github.com/apple/container/issues/461) and numerous other API changes
* Network
  * [`container network prune` removes unused networks](https://github.com/apple/container/issues/893)
  * [IPv6 network configuration, container DNS, and port forwarding](https://github.com/apple/container/issues/460)
* Storage
  * [Improve volume filesystem performance](https://github.com/apple/container/issues/882)
  * [Translate block mount options correctly, use sync mode by default](https://github.com/apple/container/issues/876)

## What's Changed
* fix(TerminalProgress): make the progress bar respect locale-specific decimal separator by @TTtie in https://github.com/apple/container/pull/936
* Fix broken image integration tests. by @jglogan in https://github.com/apple/container/pull/944
* Update CONTRIBUTORS to MAINTAINERS and point at containerization by @katiewasnothere in https://github.com/apple/container/pull/942
* [volumes]: refactor prune command by @saehejkang in https://github.com/apple/container/pull/940
* Lowercase error messages by @dkovba in https://github.com/apple/container/pull/945
* Deps: Bump Containerization to 0.16.2 by @dcantah in https://github.com/apple/container/pull/947
* feat: implement version sub command by @fatelei in https://github.com/apple/container/pull/911
* CLI: Fix -it not being able to pipe stdout by @dcantah in https://github.com/apple/container/pull/951
* [images]: refactor prune command by @saehejkang in https://github.com/apple/container/pull/941
* Feat: customize console output with env variable by @karenheckel in https://github.com/apple/container/pull/952
* Upgrade GitHub Actions for Node 24 compatibility by @salmanmkc in https://github.com/apple/container/pull/958
* Add Dependabot for GitHub Actions updates by @salmanmkc in https://github.com/apple/container/pull/960
* Upgrade GitHub Actions to latest versions by @salmanmkc in https://github.com/apple/container/pull/959
* Use new IP/CIDR types from Containerization. by @jglogan in https://github.com/apple/container/pull/957
* [networks]: add prune command by @saehejkang in https://github.com/apple/container/pull/914
* Fix: Kubes Cluster in Container Crashing Container (IS#923) by @Michaelgathara in https://github.com/apple/container/pull/930
* Turn on oops=panic kernel cmdline by @dcantah in https://github.com/apple/container/pull/971
* Add support for reading env from named pipes by @Bortnyak in https://github.com/apple/container/pull/974
* Adds network IPv6 configuration. by @jglogan in https://github.com/apple/container/pull/975
* Fix container auto-delete on rapid stop/start by @realrajaryan in https://github.com/apple/container/pull/841
* Fix MAC address option typo in how-to documentation by @claudeaceae in https://github.com/apple/container/pull/980
* Fix bash completion source path in documentation by @claudeaceae in https://github.com/apple/container/pull/981
* CLI: Fix stop not signalling waiters by @dcantah in https://github.com/apple/container/pull/972
* Fix grammar in tutorial.md by @claudeaceae in https://github.com/apple/container/pull/985
* Clarify uninstall script location in README by @claudeaceae in https://github.com/apple/container/pull/982
* Use full path for uninstall script in upgrade instructions by @claudeaceae in https://github.com/apple/container/pull/983
* Fix OSS header dates that break CI checks. by @jglogan in https://github.com/apple/container/pull/1009
* Update OSS header in Package.swift. by @jglogan in https://github.com/apple/container/pull/1010
* Fix port validation to allow same port for different protocols (#992) by @iko1 in https://github.com/apple/container/pull/1000
* CLI: Small fixups for implicit envvars by @dcantah in https://github.com/apple/container/pull/1014
* Deps: Bump Containerization to 0.19.0 by @dcantah in https://github.com/apple/container/pull/1015
* Parser: Support relative paths for --volume by @dcantah in https://github.com/apple/container/pull/1013
* Update license header on all files to include the current year by @katiewasnothere in https://github.com/apple/container/pull/1024
* makefile: Add cli target by @dcantah in https://github.com/apple/container/pull/1022
* Reorganize client libraries. by @jglogan in https://github.com/apple/container/pull/1020
* Update to containerization 0.20.0. by @jglogan in https://github.com/apple/container/pull/1027
* Tests: Fix relative path mount tests by @dcantah in https://github.com/apple/container/pull/1028
* CLI: Add read-only flag to run/create by @dcantah in https://github.com/apple/container/pull/999
* Resolve IPv6 address queries for container names. by @jglogan in https://github.com/apple/container/pull/1016
* [container]: add startedDate field by @saehejkang in https://github.com/apple/container/pull/1018
* Adds IPv6 port forwarding. by @jglogan in https://github.com/apple/container/pull/1029
* ProgressBar: Various fixes by @dcantah in https://github.com/apple/container/pull/1025
* Add instructions for using locally built init filesystem. by @jglogan in https://github.com/apple/container/pull/1032
* fix: improve error message when binding to privileged ports (fixes #978) by @Ronitsabhaya75 in https://github.com/apple/container/pull/1031
* fix: extract hostname from FQDN (#1011) by @iko1 in https://github.com/apple/container/pull/1017
* Fix: Support x86_64 architecture alias to prevent silent pull failure… by @Ronitsabhaya75 in https://github.com/apple/container/pull/1036
* Fix relative path resolution in entrypoint by @ParkSeongGeun in https://github.com/apple/container/pull/987
* Fix the FS error when using Virtualization by @JaewonHur in https://github.com/apple/container/pull/1041
* Add support for aarch64 architecture alias by @Ronitsabhaya75 in https://github.com/apple/container/pull/1040
* fix: use pax instead of tar for pkg payload extraction by @manuschillerdev in https://github.com/apple/container/pull/1038
* Fix unstable integration tests. by @jglogan in https://github.com/apple/container/pull/1060
* Adds opt-in pre-commit hook for format and header checks. by @jglogan in https://github.com/apple/container/pull/1062
* Update for containerization 0.21.0. by @jglogan in https://github.com/apple/container/pull/1056
* fix: performance warning should not output ANSI codes if stderr redirected by @iko1 in https://github.com/apple/container/pull/1059
* ContainerSvc: Handle unexpected sandbox svc exits by @dcantah in https://github.com/apple/container/pull/1065
* Throw error when starting a container with invalid virtiofs source by @JaewonHur in https://github.com/apple/container/pull/1051
* Change behavior of the default arguments in the plugin config by @katiewasnothere in https://github.com/apple/container/pull/1063
* Use configuration subnet and fallback to default subnet in allocation only plugin by @katiewasnothere in https://github.com/apple/container/pull/1057
* Update to containerization 0.21.1. by @jglogan in https://github.com/apple/container/pull/1064
* Use StderrLogHandler for rich logging features. by @jglogan in https://github.com/apple/container/pull/1066
* Select macOS 26 CI runners. by @jglogan in https://github.com/apple/container/pull/1074

## New Contributors
* @TTtie made their first contribution in https://github.com/apple/container/pull/936
* @fatelei made their first contribution in https://github.com/apple/container/pull/911
* @karenheckel made their first contribution in https://github.com/apple/container/pull/952
* @salmanmkc made their first contribution in https://github.com/apple/container/pull/958
* @Michaelgathara made their first contribution in https://github.com/apple/container/pull/930
* @Bortnyak made their first contribution in https://github.com/apple/container/pull/974
* @claudeaceae made their first contribution in https://github.com/apple/container/pull/980
* @iko1 made their first contribution in https://github.com/apple/container/pull/1000
* @ParkSeongGeun made their first contribution in https://github.com/apple/container/pull/987
* @JaewonHur made their first contribution in https://github.com/apple/container/pull/1041
* @manuschillerdev made their first contribution in https://github.com/apple/container/pull/1038

**Full Changelog**: https://github.com/apple/container/compare/0.7.1...0.8.0