diff --git a/docs/guides/developers_tutorial.md b/docs/guides/developers_tutorial.md index 7e12a5cc4..fc6e423a1 100644 --- a/docs/guides/developers_tutorial.md +++ b/docs/guides/developers_tutorial.md @@ -10,7 +10,7 @@ installed. * [oc][oc] or [kubectl][kubectl] CLI * [kn][kn] CLI -* [Docker][docker] +* [Docker][docker] or [Podman](podman.md) [docker]: https://docs.docker.com/install/ [oc]: https://docs.openshift.com/container-platform/4.6/cli_reference/openshift_cli/getting-started-cli.html#cli-installing-cli_cli-developer-commands diff --git a/docs/guides/podman.md b/docs/guides/podman.md new file mode 100644 index 000000000..08f27c719 --- /dev/null +++ b/docs/guides/podman.md @@ -0,0 +1,16 @@ +# Podman + +Under Linux, it is possible to use [podman](https://podman.io/) instead of [docker](https://www.docker.com/). + +In order to do this you need to run `podman` as a service. You can do this with the following command. +``` +❯ podman system service --time=0 +``` +This will serve the Docker API on a UNIX socket at `/run/user/{uid}/podman/podman.sock`. + +Then set the environment variable `DOCKER_HOST` to the socket so `func` knows where to connect. +``` +❯ export DOCKER_HOST="unix:///run/user/$(id -u)/podman/podman.sock" +❯ func build -v +``` +Now you may use `func` as usual.