Skip to content

Commit

Permalink
docs/build_osx.md: Describe external gvproxy
Browse files Browse the repository at this point in the history
I think many podman-MacOS developers will fit into what this
doc section describes.

Signed-off-by: Colin Walters <[email protected]>
  • Loading branch information
cgwalters committed Jan 2, 2024
1 parent 65266a3 commit f9de980
Showing 1 changed file with 14 additions and 0 deletions.
14 changes: 14 additions & 0 deletions build_osx.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,20 @@ The binary will be located in bin/
$ ls -l bin/
```

### Using gvproxy from homebrew, with podman from git

Recent podman builds depend on a `gvproxy` binary which comes from [containers/gvisor-tap-vsock](https://github.com/containers/gvisor-tap-vsock). A common development scenario may be using the podman desktop app as a baseline, with a development
binary of `podman` you build from git. To ensure that the podman you build here can find the gvproxy installed from podman desktop, use:

`make podman-remote HELPER_BINARIES_DIR=/opt/podman/bin`

(Also note that because the `Makefile` rules do not correctly invalidate the binary when this variable changes,
so if you already have a build you'll need to `rm bin/darwin/podman` first if you have an existing build).

Alternatively, you can set `helper_binaries_dir=` in `~/.config/containers/containers.conf`.

### Building docs

If you would like to build the docs associated with Podman on macOS:
```
$ make podman-remote-darwin-docs
Expand Down

0 comments on commit f9de980

Please sign in to comment.