From d40175e0aebc64a24f4987d2d1a60f3d7cbe7375 Mon Sep 17 00:00:00 2001 From: Tomas Volf Date: Tue, 23 Aug 2022 13:45:15 +0200 Subject: [PATCH] Document restrictions on transport in FROM When using remote podman client, not all transports work as expected. So document this limitation. Fixes: containers/podman#15141 Signed-off-by: Tomas Volf --- docs/source/markdown/podman-build.1.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/source/markdown/podman-build.1.md b/docs/source/markdown/podman-build.1.md index bfdfee1ed5..745f0bdf30 100644 --- a/docs/source/markdown/podman-build.1.md +++ b/docs/source/markdown/podman-build.1.md @@ -386,6 +386,12 @@ environment variable. `export BUILDAH_FORMAT=docker` Overrides the first `FROM` instruction within the Containerfile. If there are multiple FROM instructions in a Containerfile, only the first is changed. +With the remote podman client, not all container transports will work as +expected. For example, oci-archive:/x.tar will reference /x.tar on the remote +machine instead of on the client. If you need to support remote podman clients, +it is best to restrict yourself to containers-storage: and docker:// +transports. + #### **--help**, **-h** Print usage statement