Skip to content

Commit ee30368

Browse files
Brilatormr-c
andauthored
add note on docker platform issue (#2064)
Co-authored-by: Michael R. Crusoe <[email protected]>
1 parent 9cda157 commit ee30368

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

README.rst

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -189,6 +189,22 @@ and ``--tmp-outdir-prefix`` to somewhere under ``/Users``::
189189

190190
$ cwl-runner --tmp-outdir-prefix=/Users/username/project --tmpdir-prefix=/Users/username/project wc-tool.cwl wc-job.json
191191

192+
193+
Docker default platform on macOS with Apple Silicon
194+
===================================================
195+
196+
If macOS users want to run CWL tools/workflows using ``cwltool`` with Docker and their software containers only have support for amd64 (64-bit x86) CPUs, but they have an Apple Silicon (aarch64/arm64) CPU,
197+
they run into the error:
198+
199+
WARNING: The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested.
200+
201+
To fix this, export the following environment variable before executing `cwltool`:
202+
203+
``export DOCKER_DEFAULT_PLATFORM=linux/amd64``
204+
205+
To automatically have this variable set in the future, add the same command to ones respective shell profile (e.g. ``~/.zshrc``, ``~/.bash_profile``).
206+
207+
192208
Using uDocker
193209
=============
194210

0 commit comments

Comments
 (0)