Fixing Remote Conda Environment Builds

[sbrandstaeter]

🐍 Fixing Remote Conda Environment Builds

While using the remote build functionality, I ran into an issue where conda (and mamba) weren’t available when running commands via ssh, even though my .bashrc included the usual conda init block.

If you're able to run an interactive session on your host using SSH, you probably don't need to change anything.

You can check by running:

ssh user@host "which conda"

This command is used internally in remote build operations and is where I hit the problem. In my case, I was not able to get conda available in non-interactive SSH sessions.

---

❌ Problem: Missing Conda Activation in Non-Interactive SSH Sessions

The culprit was this common pattern in my .bashrc:

# If not running interactively, don't do anything
case $- in
    *i*) ;;
      *) return;;
esac

This check causes the shell to exit early in non-interactive sessions (like ssh host "cmd"), which prevents the Conda environment from being initialized.

---

✅ Fix: Move Conda and Mamba Initialization Before the Interactivity Check

To fix this, I moved the entire conda (and mamba) initialization block above the case $- check.

Here’s the corrected structure of .bashrc:

# >>> conda initialize >>>
# Managed by 'conda init'
__conda_setup="$('$HOME/miniforge3/bin/conda' 'shell.bash' 'hook' 2> /dev/null)"
if [ $? -eq 0 ]; then
    eval "$__conda_setup"
else
    if [ -f "$HOME/miniforge3/etc/profile.d/conda.sh" ]; then
        . "$HOME/miniforge3/etc/profile.d/conda.sh"
    else
        export PATH="$HOME/miniforge3/bin:$PATH"
    fi
fi
unset __conda_setup

if [ -f "$HOME/miniforge3/etc/profile.d/mamba.sh" ]; then
    . "$HOME/miniforge3/etc/profile.d/mamba.sh"
fi
# <<< conda initialize <<<

# Only run this part in interactive shells
case $- in
    *i*) ;;
      *) return;;
esac

This change ensures that:

• conda and mamba are initialized in all SSH sessions, including non-interactive ones.
• Your interactive-only settings (prompt, aliases, etc.) still only run when appropriate.

---

🔗 References

• ChatGPT
• This helpful StackOverflow post

---

Hope this saves someone else some debugging time! 😅