orbstack-best-practices

Manage OrbStack VM lifecycle and Docker integration on macOS with orb CLI commands.

Updated Aug 23, 2026

Search Tags:#troubleshooting #networking #docker #macos #ssh #vm #orbstack

Ready to run

npx skills add https://github.com/awfixers-stuff/opencode-config --skill orbstack-best-practices-awfixers-stuff

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: orbstack-best-practices
Source: https://github.com/awfixers-stuff/opencode-config/tree/main/skills/orbstack-best-practices
Command: npx skills add https://github.com/awfixers-stuff/opencode-config --skill orbstack-best-practices-awfixers-stuff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides concise, practical guidance to operate OrbStack Linux virtual machines, run Docker and Kubernetes on macOS, and use the orb CLI effectively so developers avoid common integration and networking pitfalls.

Core Features & Use Cases

Machine lifecycle & CLI: Commands and examples for creating, starting, stopping, deleting, and setting default OrbStack machines.
Docker & Kubernetes on macOS: Guidance on container domains, volumes, platform emulation, and accessing services from macOS without port mapping.
Networking, SSH, and file transfer: DNS patterns, automatic localhost routing, SSH access patterns for IDEs, and orb push/pull file transfer examples.
Troubleshooting & configuration: Diagnostic commands, engine restarts, cloud-init debugging, and recommended config settings for memory, CPU, and Rosetta.

Quick Start

Ask the assistant to list OrbStack machines and provide the orb commands to create, configure, and start a VM for Docker on macOS.

Frequently Asked Questions about orbstack-best-practices

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

FAQPage Schema

How do I manage OrbStack VMs and Docker containers on macOS?▼

Managing OrbStack VMs and Docker containers on macOS involves using the orb CLI to create, start, stop, and delete Linux machines. You can access container services directly from macOS without port mapping using automatic localhost routing.

Can I use SSH to access OrbStack Linux VMs for my IDE?▼

Yes, you can use SSH to access OrbStack Linux VMs for IDE integration. The Skill provides specific SSH access patterns and DNS configuration examples to connect your development environment directly to the virtual machines.

How do I transfer files between macOS and OrbStack VMs?▼

To transfer files between macOS and OrbStack VMs, use the orb push and orb pull CLI commands. These commands facilitate seamless file transfer for local development and testing workflows.

Why are my OrbStack Docker containers not accessible on macOS?▼

Docker containers in OrbStack may not be accessible due to networking misconfigurations or engine issues. You can resolve this by applying DNS patterns, leveraging automatic localhost routing, or running diagnostic commands to restart the engine.

What are the recommended OrbStack configuration settings for macOS?▼

Recommended OrbStack configuration settings for macOS include adjusting memory and CPU allocations, and enabling Rosetta for platform emulation. These settings optimize performance for running Linux VMs and Kubernetes locally.

How do I debug cloud-init issues in an OrbStack VM?▼

To debug cloud-init issues in an OrbStack VM, use the provided diagnostic commands and engine restart steps. This troubleshooting process helps identify configuration failures during the virtual machine lifecycle.