← Back to Skills Marketplace
Docker Osx
by
NightVibes3
· GitHub ↗
· v1.0.0
505
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install docker-osx
Description
Run macOS in Docker on Linux with KVM. Use when: user wants to build iOS apps/IPAs, needs macOS environment, wants to compile Apple apps without Mac, or want...
README (SKILL.md)
Docker-OSX
Run macOS in Docker - build iOS apps on Linux!
Quick Start
start macos # Boot VM (2-5 min)
status macos # Check if ready
ssh macos # Connect
stop macos # Shutdown
Commands
| Command | Description |
|---|---|
start macos |
Boot macOS VM |
stop macos |
Shutdown VM |
status macos |
Check running |
ssh macos |
Get SSH command |
vnc macos |
Get VNC address |
logs macos |
View logs |
Connection
- SSH: port 50922, password:
alpine - VNC: port 5900
Building iOS
# In macOS terminal:
xcode-select --install
git clone \x3Crepo>
cd repo
xcodegen generate
xcodebuild -project App.xcodeproj -scheme App -configuration Release -destination 'generic/platform=iOS' CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO build
Errors
| Error | Fix |
|---|---|
| KVM not available | Server needs hardware virtualization |
| Docker not installed | `curl -sSL get.docker.com |
Resources
- 4+ CPU cores
- 8GB+ RAM
- 100GB disk
Usage Guidance
This skill does what it says: it automates running sickcodes/docker-osx in Docker and requires KVM and Docker. Before installing/using it: (1) Understand you will pull and run a third-party container image (inspect the image on Docker Hub, verify the maintainer and recent activity). (2) Do not run it on sensitive or production hosts — the container is granted /dev/kvm access and mapped host ports. Use an isolated VM or disposable host if possible. (3) Change default credentials (SSH/VNC password 'alpine') and restrict network access. (4) Consider scanning the image for malware and reviewing the upstream repo. (5) Be aware of Apple licensing implications for running macOS on non‑Apple hardware (operational/legal, not a security scanner finding). If you cannot verify the image or isolate the runtime, treat the container as untrusted code and avoid running it on critical infrastructure.
Capability Analysis
Type: OpenClaw Skill
Name: docker-osx
Version: 1.0.0
The skill is classified as suspicious primarily due to the explicit instruction in both `SKILL.md` and `scripts/docker_osx.py` to install Docker using `curl -sSL get.docker.com | sh`. This method is a significant security risk, vulnerable to supply chain attacks or man-in-the-middle attacks, and represents a potential prompt injection vulnerability if the AI agent were to automatically execute this 'fix'. Additionally, the skill runs a Docker container with `--device /dev/kvm`, granting high privileges to the container, which, while necessary for its function, relies heavily on the integrity of the `sickcodes/docker-osx:stable` image. A weak default password ('alpine') is also used for the guest macOS VM.
Capability Assessment
Purpose & Capability
The name/description (run macOS in Docker with KVM to build iOS apps) matches the declared requirements and code: it requires docker and KVM, and the script runs docker commands using the sickcodes/docker-osx image. Nothing requested is unrelated to running a macOS VM in Docker.
Instruction Scope
SKILL.md and the script stick to VM lifecycle and connection tasks (start/stop/status/logs/ssh/vnc). They do not read unrelated host files or request extra credentials. However SKILL.md suggests installing Docker via `curl -sSL get.docker.com | sh` (network-fetch-and-execute) and documents insecure default credentials (SSH password 'alpine') and exposed host ports (50922, 5900), which are operational/security concerns.
Install Mechanism
There is no install spec (instruction-only), which is low-risk for local files. At runtime the script invokes `docker run` which will pull the image sickcodes/docker-osx:stable from Docker Hub if not present — running an external, third-party container image effectively downloads and executes remote code. This is expected for this use case but is a trust boundary you must evaluate (verify image publisher, check image contents, run in isolated environment).
Credentials
The skill requests no environment variables or credentials, which is appropriate. Note: it relies on Docker daemon access (implicit requirement) and uses a documented default password ('alpine') for SSH/VNC — an insecure default that users should change.
Persistence & Privilege
always:false and no special persistent privileges are requested. Runtime behavior requires access to the host's Docker daemon and maps /dev/kvm into the container (needed for virtualization). Mapping /dev/kvm and exposing ports is required for functionality but increases the container's ability to interact with host resources — run only on hosts where this is acceptable.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install docker-osx - After installation, invoke the skill by name or use
/docker-osx - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of docker_osx (v1.0.0):
- Enables running macOS in Docker on Linux using KVM.
- Provides commands to start, stop, check, and connect (SSH/VNC) to the macOS VM.
- Includes a quick-start guide and sample workflow for building iOS apps.
- Lists hardware/software requirements and common troubleshooting tips.
- Not suitable for servers without KVM support or low-resource systems.
Metadata
Frequently Asked Questions
What is Docker Osx?
Run macOS in Docker on Linux with KVM. Use when: user wants to build iOS apps/IPAs, needs macOS environment, wants to compile Apple apps without Mac, or want... It is an AI Agent Skill for Claude Code / OpenClaw, with 505 downloads so far.
How do I install Docker Osx?
Run "/install docker-osx" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Docker Osx free?
Yes, Docker Osx is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Docker Osx support?
Docker Osx is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Docker Osx?
It is built and maintained by NightVibes3 (@nightvibes3); the current version is v1.0.0.
More Skills