Guides

Guides

A task-oriented how-to index, in the spirit of dip/Homebrew/Rails Guides. Individual entries can split into their own pages later if they grow large.

Outline

• Migrating from dip
  • interaction: works as-is (it's the primary spelling, same as in dip)
  • The commands: alias, and why declaring both is an error
  • dip features wip doesn't cover yet (e.g. wip provision, see Roadmap)
• Guide for Docker Compose users
  • Choosing between the two ways to reuse an existing compose.yml (mode: compose vs. mode: compose-native)
  • Compose features compose-native doesn't support (health checks, long-syntax volumes, scaling, ...) and workarounds
• Fixing a slow boot (the bind-mount problem)
  • Recognizing the symptom (--debug log shows low CPU/memory while it looks hung)
  • Root cause (virtiofs-backed bind mounts + frameworks like Zeitwerk doing many small stat/opens)
  • Adding a sync: block (minimal config → customizing exclude patterns)
  • Example: a dedicated rsync image via sync.build
• Running sync continuously (wip sync --watch)
  • The two-terminal workflow (wip up -d + wip sync --watch)
  • The one-way-sync gotcha (container→host writes get wiped) and how exclude/delete: false avoid it
• Auto-restarting exited containers (wip up --watch)
  • Example restart: configuration
  • Limits of polling vs. events (races with wip stop run from another terminal)
• Preparing multi-arch images (fixing CPU architecture mismatches)
  • Example docker buildx multi-arch build
• Using wip in CI/automation (forward-looking)
  • Behavior in non-TTY environments, when to reach for --no-interactive