convert-to-apple-container

Migrate NanoClaw deployments from Docker to Apple Container on macOS.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/theowenyoung/nanoclaw --skill convert-to-apple-container-theowenyoung
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convert-to-apple-container
Source: https://github.com/theowenyoung/nanoclaw/tree/main/.claude/skills/convert-to-apple-container
Command: npx skills add https://github.com/theowenyoung/nanoclaw --skill convert-to-apple-container-theowenyoung

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a deterministic migration path for NanoClaw users who want to replace Docker with Apple's Container runtime on macOS, addressing incompatibilities with file mounts and ensuring OS-level isolation without broad codebase churn.

Core Features & Use Cases

  • Replaces the container runtime binary and CLI usage with Apple Container and updates build and run scripts accordingly.
  • Converts Docker-style mount syntax to Apple Container mount semantics and moves .env shadowing into the container entrypoint with a safe privilege-drop sequence.
  • Includes tests, intents, and verification steps to validate runtime status, image builds, readonly/read-write mount behavior, and orphaned container cleanup.
  • Use case: Migrate a NanoClaw installation on macOS to the native runtime to avoid Docker/VirtioFS mount errors and enable per-group isolation with validated mounts.

Quick Start

Run the convert-to-apple-container skill to migrate NanoClaw to Apple Container on a macOS host and run the provided tests and verification steps.

Frequently Asked Questions about convert-to-apple-container

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate from Docker to Apple Container on macOS?

To migrate from Docker to Apple Container on macOS, you need to update runtime binary references, convert mount syntax, and adjust startup checks. This migration replaces Docker CLI commands with Apple Container equivalents for native macOS isolation.

Does Apple Container support Docker-style file mounts for NanoClaw?

Apple Container does not natively support Docker-style file mounts for NanoClaw without conversion. You must convert Docker-style mount syntax to Apple Container mount semantics and move environment shadowing into the entrypoint with a privilege-drop sequence.

Why do I get VirtioFS mount errors with Docker on macOS?

VirtioFS mount errors with Docker on macOS occur due to file mount incompatibilities. Migrating to Apple Container provides native macOS container isolation, avoiding these Docker/VirtioFS mount errors and ensuring valid read-write mount behavior.

Can I use Apple Container for per-group isolation on macOS?

Yes, you can use Apple Container for per-group isolation on macOS. Migrating your NanoClaw deployment to this native runtime enables per-group isolation with validated mounts, replacing Docker's virtualization layer with OS-level isolation.

What are the limitations of migrating NanoClaw to Apple Container?

Migrating NanoClaw to Apple Container requires updating readonly mount flags, orphan cleanup logic, and build scripts. You must verify runtime status and image builds through provided tests to ensure a clean migration without broad codebase churn.