olafgeibig/container-use
skills/container-use/SKILL.md
Use this skill when working with Apple Containers (lightweight Linux VMs) as a native Docker replacement on macOS. This includes building container images, running containers, managing container lifecycle, configuring networking, handling volumes, mounting files with SSH forwarding, or performing multi-platform builds. Invoke for tasks involving the container CLI, Apple container tool, or Linux containers on Apple Silicon macOS 26+.
tools
Updated May 5, 2026
$ install --global
skillsauthnpx skillsauth add olafgeibig/skills container-useInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 5, 2026, 7:28 AM136.7s4 files scanned
SKILL.md
- name:
- container-use
- description:
- Use this skill when working with Apple Containers (lightweight Linux VMs) as a native Docker replacement on macOS. This includes building container images, running containers, managing container lifecycle, configuring networking, handling volumes, mounting files with SSH forwarding, or performing multi-platform builds. Invoke for tasks involving the container CLI, Apple container tool, or Linux containers on Apple Silicon macOS 26+.
- license:
- Apache-2.0
- compatibility:
- Requires Apple Container tool installed and macOS 26+ (Apple Silicon)
- source:
- https://github.com/olafgeibig/skills
- version:
- 0.1.1
Apple Container Usage
Guide for using Apple's container tool to run Linux containers on macOS.
TL;DR
container runs Linux containers in lightweight virtual machines (one VM per container) on macOS 26+ (Apple Silicon). It creates a native, secure, and performant alternative to Docker Desktop.
When to Use
- You want to run Linux containers on macOS without the overhead of Docker Desktop.
- You need strong isolation (VM per container).
- You are developing on macOS 26+ with Apple Silicon.
- You want to build multi-platform images (arm64/amd64).
Installation
- Download: Get the latest signed
.pkgfrom GitHub Releases. - Install: Double-click the
.pkgand follow instructions. - Start Service:
container system start
Common Workflows
1. Running Containers
Basic run (similar to Docker):
# Run interactive alpine shell
container run -it --rm alpine:latest sh
# Run web server detached with port mapping
container run -d --name web -p 8080:80 nginx:latest
Key Options:
--cpus <count>: Limit CPUs (default: 4)--memory <size>: Limit RAM (default: 1G). e.g.,--memory 4g--volume <host>:<container>: Mount volumes.container run -v ~/project:/code python:3.9--ssh: Forward host SSH agent (great for git in containers).container run --ssh -it ubuntu git clone [email protected]:me/repo.git--mac-address <addr>: Set custom MAC address.
2. Building Images
Builds run in a special builder VM.
# Build current directory
container build -t my-app:latest .
# Build for multiple architectures
container build --arch arm64 --arch amd64 -t my-app:multi .
Tip: Increase builder resources if builds are slow:
container builder start --cpus 8 --memory 16g
3. Managing State
# List running containers
container ls
# List all (including stopped)
container ls -a
# Stop/Start
container stop <name>
container start <name>
# View logs
container logs -f <name>
# Monitor stats (CPU/RAM)
container stats
4. Networking
Apple Containers use vmnet. Each network is isolated.
# Create a new isolated network
container network create backend --subnet 192.168.100.0/24
# Run container in network
container run --network backend nginx
References
- Tutorial - Guided tour of building and running a simple web server.
- How-to Guide - Tasks like sharing files, multi-platform builds, and networking.
- Command Reference - Comprehensive list of CLI commands and options.
Migration from Docker
| Docker Command | Container Command | Notes |
| :--- | :--- | :--- |
| docker run ... | container run ... | Mostly compatible flags (-v, -p, -d, -it) |
| docker ps | container ls | |
| docker build ... | container build ... | |
| docker logs ... | container logs ... | |
| docker exec ... | No direct equivalent yet | Use ssh or attach if supported, or design containers to not need exec. |
| docker network ... | container network ... | |
Key Differences:
- Architecture: Docker Desktop uses one big VM.
containeruses one lightweight VM per container. This improves isolation but changes resource usage patterns. - Storage: Images and containers are stored in
~/Library/Containers/.... - Daemon: The daemon (
vminitd) runs per-container inside the VM.
Troubleshooting
System Logs: If something fails, check the system logs:
container system logs
Uninstall: To remove everything (including data):
/usr/local/bin/uninstall-container.sh -d
Related Skills
olafgeibig/vault-wiki
development
VerifiedTrustedCommunity
Multi-domain LLM Wiki in vault — build and maintain a federation of interlinked markdown wiki knowledge bases inside your Obsidian vault. Each domain wiki has its own schema, index, and log, linked across boundaries via path-based wikilinks. Use when user wants to use a wiki (create, ingest into, query, lint).
SKILL.mdUpdated May 30, 2026
olafgeibig/turbovault-use
tools
VerifiedTrustedCommunity
Safe and effective use of TurboVault MCP tools — vault selection, active vault management, read/write/edit_note patterns, SEARCH/REPLACE syntax, search tools, graph tools, batch operations, verification, and troubleshooting. Load this skill whenever a task uses mcp_turbovault_* tools.
SKILL.mdUpdated May 30, 2026
olafgeibig/skills/skill-templates/skill-improvements
testing
VerifiedTrustedCommunity
--- name: {{BUNDLE_NAME}}-improvements description: "Container for agent-discovered optimizations to the {{BUNDLE_NAME}} bundle — {{SKILL_NAMES}}" metadata: version: "0.3.0" source: https://github.com/olafgeibig/skills hermes: tags: [template, improvement, bundle, profile] related_skills: [{{SKILL_NAMES}}] --- # {{BUNDLE_NAME}} Improvements This skill collects all improvements discovered while working with {{SKILL_LIST}}. Core skills remain untouched. **Profile-specific:** This
SKILL.mdUpdated May 30, 2026
olafgeibig/skill-templates/skill-improvements
testing
VerifiedTrustedCommunity
--- name: {{BUNDLE_NAME}}-improvements description: "Container for agent-discovered optimizations to the {{BUNDLE_NAME}} bundle — {{SKILL_NAMES}}" metadata: version: "0.3.0" source: https://github.com/olafgeibig/skills hermes: tags: [template, improvement, bundle, profile] related_skills: [{{SKILL_NAMES}}] --- # {{BUNDLE_NAME}} Improvements This skill collects all improvements discovered while working with {{SKILL_LIST}}. Core skills remain untouched. **Profile-specific:** This
SKILL.mdUpdated May 30, 2026