From 0a9cc7b396e8ed58d3980004f2e61dd2e1688206 Mon Sep 17 00:00:00 2001 From: Christopher Hakkaart Date: Thu, 19 Mar 2026 14:17:22 +1300 Subject: [PATCH] Add note about oras behavior Signed-off-by: Christopher Hakkaart --- docs/reference/env-vars.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/reference/env-vars.md b/docs/reference/env-vars.md index 63d0d47dac..a16334a838 100644 --- a/docs/reference/env-vars.md +++ b/docs/reference/env-vars.md @@ -218,11 +218,17 @@ The following environment variables control the configuration of the Nextflow ru `NXF_SINGULARITY_CACHEDIR` : Directory where remote Singularity images are stored. When using a computing cluster it must be a shared folder accessible from all compute nodes. +: :::note + The `NXF_SINGULARITY_CACHEDIR` variable is not applied when a container image is specified using an `oras://` URI. In that case, the image reference is passed directly to Singularity, independently of Nextflow's caching mechanism. + ::: `NXF_SINGULARITY_LIBRARYDIR` : :::{versionadded} 21.09.0-edge ::: : Directory where remote Singularity images are retrieved. It should be a directory accessible to all compute nodes. +: :::note + The `NXF_SINGULARITY_LIBRARYDIR` variable is not applied when a container image is specified using an `oras://` URI. In that case, the image reference is passed directly to Singularity, independently of Nextflow's caching mechanism. + ::: `NXF_SPACK_CACHEDIR` : Directory where Spack environments are stored. When using a computing cluster it must be a shared folder accessible from all compute nodes.