diff options
| author | OpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com> | 2021-01-29 15:10:40 -0500 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-01-29 15:10:40 -0500 |
| commit | 2686e406a650f8ceac4b3763e0cfba16090d1c1b (patch) | |
| tree | 46a5276918af1ca9300ed5d651f9f9e27801ba4d | |
| parent | f7573efa045035afaf3f74752c73a298b8605da1 (diff) | |
| parent | b842d97f5b42bf8746336e98a864259a556b7de7 (diff) | |
| download | podman-2686e406a650f8ceac4b3763e0cfba16090d1c1b.tar.gz podman-2686e406a650f8ceac4b3763e0cfba16090d1c1b.tar.bz2 podman-2686e406a650f8ceac4b3763e0cfba16090d1c1b.zip | |
Merge pull request #9161 from baude/macosbuild
[CI:DOCS]build instructions for macOS
| -rw-r--r-- | build_osx.md | 55 |
1 files changed, 55 insertions, 0 deletions
diff --git a/build_osx.md b/build_osx.md new file mode 100644 index 000000000..59e1797a6 --- /dev/null +++ b/build_osx.md @@ -0,0 +1,55 @@ +# Building the Podman client on macOS + +The following describes the process for building the Podman client on macOS. + +## Install brew +Podman requires brew -- a package manager for macOS. This will allow additional packages to be installed that are +needed by Podman. See the [brew project page](https://brew.sh/) for installation instructions. + +##Install build dependencies +Podman requires some software from brew to be able to build. This can be done using brew from a macOS terminal: + +``` +$ brew install go go-md2man +``` + +## Obtain Podman source code + +You can obtain the latest source code for Podman from its github repository. + +``` +$ git clone http://github.com/containers/podman go/src/github.com/containers/podman +``` + +## Build client +After completing the preparatory steps of obtaining the Podman source code and installing its dependencies, the client +can now be built. + +``` +$ cd go/src/github.com/containers/podman +$ make podman-remote-darwin +$ mv bin/podman-remote-darwin bin/podman +``` + +The binary will be located in bin/ +``` +$ ls -l bin/ +``` + +If you would like to build the docs associated with Podman on macOS: +``` +$ make install-podman-remote-darwin-docs +$ ls docs/build/remote/darwin +``` + +To install and view these manpages: + +``` +$ cp -a docs/build/remote/darwin/* /usr/share/man/man1 +$ man podman +``` + +## Using the client + +To learn how to use the Podman client, refer its +[tutorial](https://github.com/containers/podman/blob/master/docs/tutorials/remote_client.md). |