Files
pickle-RickA 565e8a3e02 Improve documentation formatting and consistency (#633)
Small documentation improvements for better consistency:

- Fixed capitalization (url → URL) in kernel README
- Added bash syntax highlighting to code block in lab.md  
- Improved formatting consistency in ctr-example README (added colon +
code fence)

Co-authored-by: pickle-RickA <273219719+pickle-RickA@users.noreply.github.com>
2026-05-27 00:23:39 -07:00
..

Container Example

Very basic example of launching a Linux container using Containerization.

Build and Run

1. Fetch Kernel

In your terminal, change directories to examples/ctr-example and run:

Option A: Using Makefile (recommended)

make fetch-default-kernel

Option B: Copy from installed container tool

cp "$(ls -t ~/Library/Application\ Support/com.apple.container/kernels/vmlinux-* | head -1)" ./vmlinux

You should now see the vmlinux image in examples/ctr-example

2. Build/Run ctr-example

From examples/ctr-example run:

make all

Warning

If you get the following error, try building from the default macOS terminal: error: compiled module was created by a newer version of the compiler

After the build completes, the example will run. In your terminal you should see something like:

Starting container example...
Fetching container initial filesystem...
Creating container from docker.io/library/alpine:3.16...
Starting container...
/ #

Warning

If you get the following error, try moving the ctr-example binary to /var/tmp and run it from there. Swift/ErrorType.swift:254: Fatal error: Error raised at top level: unsupported: "failed to create vmnet network with status vmnet_return_t(rawValue: 1001)"

Congratulations, you've started the example container!