summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorOpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com>2021-01-29 15:10:40 -0500
committerGitHub <noreply@github.com>2021-01-29 15:10:40 -0500
commit2686e406a650f8ceac4b3763e0cfba16090d1c1b (patch)
tree46a5276918af1ca9300ed5d651f9f9e27801ba4d
parentf7573efa045035afaf3f74752c73a298b8605da1 (diff)
parentb842d97f5b42bf8746336e98a864259a556b7de7 (diff)
downloadpodman-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.md55
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).