alpine

Minimal Alpine Linux base image for Apple's native Containerization framework.

Prerequisites

• macOS 26+ (Tahoe)
• Apple Silicon
• container CLI installed
• container-cast (for standalone binaries)

Usage

Run as container

make build # Build the image
make run # Spawn ephemeral shell at alpine.box

Cast as standalone binary

make install # Build, cast, and install to /usr/local/bin
alpine # Launch interactive shell
alpine <command># Run a single command

All targets

make status Show builder, DNS, images, and containers
make build Build the container image
make cast Cast into a standalone binary
make install Cast and install to /usr/local/bin
make uninstall Remove from /usr/local/bin
make run Run the container
make clean Remove image and prune unused resources
make dns Configure .box DNS domain (run once, needs sudo)
make nuke Kill and restart the builder (fixes hangs)
make help Show all targets

What's Inside

• Alpine Linux (latest)
• BusyBox utilities
• ash shell

Smallest footprint base image. Use as a foundation for containers needing minimal dependencies.

License

MIT