Skip to content

Releases: A3S-Lab/Box

v0.8.15

22 Mar 10:26

Choose a tag to compare

v0.8.14

22 Mar 09:46

Choose a tag to compare

Full Changelog: v0.8.13...v0.8.14

v0.8.13

22 Mar 09:12

Choose a tag to compare

Full Changelog: v0.8.12...v0.8.13

v0.8.12

19 Mar 19:28

Choose a tag to compare

Full Changelog: v0.8.11...v0.8.12

v0.8.10

19 Mar 14:49

Choose a tag to compare

Full Changelog: v0.8.9...v0.8.10

v0.8.9

18 Mar 00:42

Choose a tag to compare

🎉 What's New in v0.8.9

🐛 Bug Fixes

macOS MicroVM Support - Fixed container execution in pure MicroVM mode on macOS

This release fixes a critical issue where containers couldn't execute in MicroVM mode on macOS. The fix implements proper rootfs mounting in the guest init process, enabling native MicroVM execution without Docker or Podman.

✨ Key Improvements

  • Rootfs Mounting: Guest init now detects and mounts /dev/root virtiofs device
  • Filesystem Pivot: Implemented proper pivot_root using chroot/chdir
  • Library Discovery: Set DYLD_LIBRARY_PATH for libkrunfw on macOS
  • Enhanced Debugging: Added filesystem diagnostics for troubleshooting
  • Simplified Build: Streamlined OCI build RUN handler for macOS

🔧 Technical Details

Changes:

  • guest/init: Added /dev/root virtiofs detection and mounting logic
  • guest/init: Implemented pivot_root to switch to container rootfs
  • runtime/vmm: Set DYLD_LIBRARY_PATH for libkrunfw discovery
  • runtime/oci: Simplified macOS RUN handler

Workflow:

  1. Detect /dev/root virtiofs device
  2. Mount to /mnt/newroot
  3. Move essential mounts (/proc, /sys, /dev)
  4. Pivot to new root using chroot/chdir
  5. Continue with normal container execution

🧪 Tested Platforms

  • Platform: macOS (Apple Silicon)
  • Runtime: libkrun (native virtiofs)
  • Images: alpine:latest, ubuntu:24.04

📦 Installation

# Using Homebrew (recommended)
brew install a3s-lab/tap/a3s-box

# Or download binary from releases

🚀 Usage

# Run container in pure MicroVM mode (no Docker/Podman needed)
a3s-box run alpine:latest -- echo "Hello from MicroVM"

Full Changelog: v0.8.8...v0.8.9

Full Changelog: v0.8.8...v0.8.9

v0.8.8

12 Mar 13:11

Choose a tag to compare

Full Changelog: v0.8.7...v0.8.8

v0.8.7

11 Mar 14:24

Choose a tag to compare

Full Changelog: v0.8.6...v0.8.7

v0.8.6

11 Mar 04:23

Choose a tag to compare

Full Changelog: v0.8.5...v0.8.6

v0.8.5

10 Mar 10:22

Choose a tag to compare

Full Changelog: v0.8.4...v0.8.5