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