Skip to main content

Installation

Requirements

  • Go 1.21+ (for go install)
  • Docker — Docker Desktop or OrbStack on macOS, Docker Engine on Linux
  • rsync — Must be available on your PATH

Check Dependencies

Install via Go

This places the graft binary in $GOPATH/bin (default: ~/go/bin/graft). Ensure $GOPATH/bin is on your PATH.

Build from Source

Verify Installation

You should see:

Environment Variables

Notes for macOS

Docker Desktop (4.22+) and OrbStack both support bind mounts via virtio-fs, a high-performance filesystem sharing protocol. Graft’s bind mount mode works on both. On older Docker Desktop versions (before 4.22), bind mount performance may be noticeably slower due to the legacy osxfs filesystem sharing.