Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add note on docker platform issue #2064

Merged
merged 5 commits into from
Nov 8, 2024
Merged

add note on docker platform issue #2064

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
d046a6c
add note on docker with Apple Silicon
Brilator Nov 7, 2024
f9aeabc
fix backticks
Brilator Nov 7, 2024
7424dbb
style
Brilator Nov 7, 2024
9da5ce2
tweaks
mr-c Nov 7, 2024
1674318
fix my typo
mr-c Nov 7, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -189,6 +189,22 @@ and ``--tmp-outdir-prefix`` to somewhere under ``/Users``::

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


Docker default platform on macOS with Apple Silicon
===================================================

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,
they run into the error:

WARNING: The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm64/v8) and no specific platform was requested.

To fix this, export the following environment variable before executing `cwltool`:

``export DOCKER_DEFAULT_PLATFORM=linux/amd64``

To automatically have this variable set in the future, add the same command to ones respective shell profile (e.g. ``~/.zshrc``, ``~/.bash_profile``).


Using uDocker
=============

Expand Down