From 5b06b2e77b07f35e489e307e296f26016cd4aa0c Mon Sep 17 00:00:00 2001 From: Tomas Volf Date: Tue, 23 Aug 2022 13:45:15 +0200 Subject: 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.in | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/source/markdown/podman-build.1.md.in b/docs/source/markdown/podman-build.1.md.in index dab705f94..209458181 100644 --- a/docs/source/markdown/podman-build.1.md.in +++ b/docs/source/markdown/podman-build.1.md.in @@ -297,6 +297,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 -- cgit v1.2.3-54-g00ecf