0.8.0

[jglogan]

Highlights

⌨️ denotes breaking CLI changes.

👩‍💻 denotes breaking API changes.

• Core
  • Fixed panics filesystem data integrity errors when stressing containers
  • Numerous stability fixes for container start and stop.
  • container system version shows version info
  • `--read-only command for container create/run mounts root filesystem read-only
  • Add platform architecture aliases for amd64 and arm64
  • 👩‍💻 Reorganized client APIs and numerous other API changes
• Network
  • container network prune removes unused networks
  • IPv6 network configuration, container DNS, and port forwarding
• Storage
  • Improve volume filesystem performance
  • Translate block mount options correctly, use sync mode by default

What's Changed

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

New Contributors

• @TTtie made their first contribution in fix(TerminalProgress): make the progress bar respect locale-specific decimal separator #936
• @fatelei made their first contribution in feat: implement version sub command #911
• @karenheckel made their first contribution in Feat: customize console output with env variable #952
• @salmanmkc made their first contribution in Upgrade GitHub Actions for Node 24 compatibility #958
• @Michaelgathara made their first contribution in Fix: Kubes Cluster in Container Crashing Container (IS#923) #930
• @Bortnyak made their first contribution in Add support for reading env from named pipes #974
• @claudeaceae made their first contribution in Fix MAC address option typo in how-to documentation #980
• @iko1 made their first contribution in Fix port validation to allow same port for different protocols (#992) #1000
• @ParkSeongGeun made their first contribution in Fix relative path resolution in entrypoint #987
• @JaewonHur made their first contribution in Fix the FS error when using Virtualization #1041
• @manuschillerdev made their first contribution in fix: use pax instead of tar for pkg payload extraction #1038

Full Changelog: 0.7.1...0.8.0

---

This discussion was created from the release 0.8.0.

[claudeaceae]

Thanks for including my documentation fixes in this release! Excited to see 0.8.0 ship with all these improvements - the IPv6 support and stability fixes look great.

[jglogan]

Of course! Thank you for contributing; keep up the good work!

It's still a work in progress - the focus for now is on reliability, UX, and reorganizing the code over a well-defined container management API, rather than aggressively chasing features.

[Ronitsabhaya75]

@jglogan thank you for including me as student it's great to be part of this amazing project 🥹. I appreciate you for the guidance and feedback you gave me on every change I made.

[jglogan]

Also want to mention that we just updated the release notes to account for a low priority CVE that allowed container image load to extract files outside the extraction directory. The 0.8.0 release (and the 0.21.0 release of containerization fixes the issue).