Skip to content

fix: redirect HOME to /tmp in Nextflow env so ChimeraX can write its data dir#104

Merged
St3451 merged 3 commits into
masterfrom
fix/pipeline-chimerax-home
May 28, 2026
Merged

fix: redirect HOME to /tmp in Nextflow env so ChimeraX can write its data dir#104
St3451 merged 3 commits into
masterfrom
fix/pipeline-chimerax-home

Conversation

@St3451
Copy link
Copy Markdown
Collaborator

@St3451 St3451 commented May 28, 2026

Summary

ChimeraX initializes a per-user data dir at $HOME/.chimerax/ on first invocation. Singularity passes the host $HOME through to the container; on most clusters that path is read-only inside the container, so ChimeraX fails with Unable to make user's data directory: Read-only file system and silently produces no PNG output during chimerax-plot.

Override HOME=/tmp at the pipeline env level so ChimeraX has a writable home regardless of host config.

…ingularity

ChimeraX initializes a per-user data dir at \$HOME/.chimerax/ on first invocation.
Singularity passes the host \$HOME through to the container; on most clusters
that path is read-only inside the container, so ChimeraX fails with
"Unable to make user's data directory: Read-only file system" and silently
produces no PNG output during chimerax-plot.

Override HOME=/tmp at the pipeline env level (mirroring the workaround already
used in deepCSA) so ChimeraX has a writable home regardless of host config.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 28, 2026 16:01
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the Nextflow pipeline configuration to ensure ChimeraX can initialize its per-user data directory inside containerized runs by redirecting HOME to a writable location (/tmp), addressing failures on clusters where the container-visible $HOME is not writable.

Changes:

  • Add HOME=/tmp to the pipeline-wide env {} block in nextflow.config.
  • Document the rationale for redirecting HOME (ChimeraX writes ~/.chimerax on first run).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread oncodrive3d_pipeline/nextflow.config Outdated
Comment thread oncodrive3d_pipeline/nextflow.config
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

Comment thread oncodrive3d_pipeline/modules/o3d_chimerax_plot.nf
@St3451 St3451 merged commit 4038672 into master May 28, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants