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

59 lines
1.3 KiB
Markdown

#
## Install and test the container tool:
See https://github.com/apple/container/releases
Once installed, start the service and follow prompts.
```bash
container system start
```
This'll install your kernel.
After this start your first container. On first launch, this'll install another artifact for our guest init process:
```bash
container run alpine uname
```
Container starts after this will be fast!
## Get the Containerization sources:
```bash
$ git clone https://github.com/apple/containerization.git
```
> [!IMPORTANT]
> There is a bug in the `vmnet` framework on macOS 26 that causes network creation to fail if the creating applications are located under your `Documents` or `Desktop` directories. To workaround this, clone the project elsewhere, such as `~/projects/containerization`, until this issue is resolved.
## Take a look at ctr-example
Read through the sources:
- ContainerManager:
- manager.create()
- container.create(), start(), wait(), stop()
## Fetch the kernel
Run
```bash
cp "$(ls -t ~/Library/Application\ Support/com.apple.container/kernels/vmlinux-* | head -1)" ./vmlinux
```
## Build and run the example
```bash
$ cd examples/ctr-example
$ make
```
## Modify the project
- Change the command run by the container
- Change the image