Conda Issues
Conda issues can be the root cause for just about any issue on this page. Scroll through this section for what may look familiar, and follow those instructions:
404 error, The channel is not accessible or is invalid.
If you are receiving this, you may be victim of us changing the channel name out from underneath you (Sorry!). Remove the offending channel(s):
conda config --remove channels https://mooseframework.inl.gov/conda/moose conda config --remove channels https://mooseframework.com/conda/moose conda config --remove channels https://mooseframework.inl.gov/conda/mooseIf you receive errors about a channel not present (CondaKeyError), please ignore. You most likely will not have all three 'old' channels. Next, add the correct channel:
conda config --add channels https://conda.software.inl.gov/publicWhen you're finished, a
conda config --show channelsshould resemble the following:$ conda config --show channels channels: - https://conda.software.inl.gov/public - conda-forge - defaultsDownload error, Timeouts
Conda packages we produce can be quite large, and can trigger the default download timeout imposed upon by Conda's download routines. You can increase this time in the following way:
conda config --set remote_read_timeout_secs new_timeoutWhere
new_timeoutis an integer greater than60(the default in seconds).command not found: conda
You have yet to install conda, or your path to it is incorrect or not set. You will need to recall how you installed conda. Our instructions ask to have Miniforge installed to your home directory:
~/miniforge. Which requires you to set your PATH accordingly:export PATH=~/miniforge/bin:$PATHWith PATH set, try to run again, what ever command you were initially attempting.
conda activate moose
If
conda activate mooseis failing like so:Run 'conda init --all' to be able to run conda activate/deactivate and start a new shell session. Or use conda to activate/deactivate....it's possible you have yet to perform a
conda init --all.It could also mean you have an older version of Conda, or that the environment you are trying to activate is somewhere other than where conda thinks it should be, or simply missing / not yet created. Unfortunately, much of what can be diagnosed, is going to be beyond the scope of this document, and better left to the support teams at Conda. What we can attempt, is to create a new environment and go from there:
conda create -n testing -q -yThe above should create an empty environment. Try and activate it:
conda activate testingIf the command continues to ask you to perform a
conda init --allor the command failed, or theconda createcommand before it, the error will likely be involved with how Conda was first installed (perhaps with sudo rights, or as another user). You should look into removing this installation of conda, and starting over with our Getting Started instructions. Failures of this nature can also mean your conda resource file (~/.condarc) is in bad shape. We have no way of diagnosing this in a troubleshooting fashion, as this file can contain more than just moose-related configs. For reference, the bare minimum should resemble the following:channels: - https://conda.software.inl.gov/public - conda-forge - defaultsconda init
If
conda init --allis failing, or similarly doing nothing, it is possible that Conda simply does not support the shell you are operating in. To figure out what shell you are operating in run the following:echo $0What ever returns here, is the type of shell you are operating in. Please verify this is a shell that Conda supports.
Your issue not listed
The quick fix-attempt, is to delete the faulty environment and re-install it:
conda activate base conda env remove -n moose conda create -n moose moose-dev=2025.10.21=mpich conda activate mooseIf the above re-install method ultimately failed, it is time to submit your errors to the discussion forum.