Follow these instructions to set up your environment for MOOSE


Install the following Ubuntu packages:

sudo -E apt-get install build-essential \
 gfortran \
 tcl \
 git \
 m4 \
 freeglut3 \
 doxygen \
 libblas-dev \
 liblapack-dev \
 libx11-dev \
 libnuma-dev \
 zlib1g-dev \

Redistributable Package

Note: If you are here to upgrade to the latest package, you must first uninstall the old one. Please see the section "Uninstall" below for instructions on how to do this.

In order to simplify the process of getting your environment set up the MOOSE team provides convenient, pre-compiled installable packages that do all the heavy lifting for you!

Note: Due to the size of the package, it may take quite a while to install (upwards of an hour).

  • MOOSE Environment package (choose one):

When the download is complete, install the package with the following command:

sudo dpkg -i <name of package you downloaded above>

Note: Ubuntu will normally download binaries to your '~/Downloads' directory.

Post Install

Add the following to your ~/.bashrc file to source the MOOSE environment. Once added, any new terminal window opened, will now have the necessary MOOSE environment.

# Source MOOSE Environment
if [ -f /opt/moose/environments/moose_profile ]; then
  . /opt/moose/environments/moose_profile

Lots of people seem to skip this step... so here it is, enlarged and bolded:

The most important step of all: Close all opened terminal windows and re-open them.

Verify you have performed the above setup instructions correctly, by opening a new terminal window, and entering the following command:

module list

If you do not see anything prefixed with the words 'moose', something is wrong.

Now that the MOOSE environment is available, continue to step 2 on the Getting Started pages.

More Information

You can verify the current version installed by performing the following command:

dpkg -l | grep moose

For more information about what our Redistributable Package contains see the wiki entry here.


To uninstall the moose-environment package, you can use the built in package manager:

sudo -E dpkg -r moose-environment

# See note below before performing the next command
sudo -E dpkg -r moose-framework

Note: Previous versions of our moose-environment package were incorrectly named 'moose-framework'. Versions affected: anything below 1.1-9. For those versions, it will be necessary to specify 'moose-framework' as the name of the package to remove.

Or manually remove the lines from your .bashrc and remove everything under /opt/moose. Deleting an installed package this way 'irritates' your package manager... It is recommended to allow the package manager to remove packages.

R&D 100

Recent Blog Posts

Using our new clang-format Style

8 months, 2 weeks ago

Steady State Algorithm Change

1 year, 5 months ago

Making an App inherit from an App

1 year, 5 months ago

Changing a published API (Deprecation)

1 year, 6 months ago

DiscreteMaterial Objects

1 year, 8 months ago

Recent Tweets