Minimum System Requirements

  • Compiler: C++11 Compliant GCC 4.8.4, Clang 3.4.0, Intel20130607
  • Python 2.7+
  • Memory: 16 GBs (debug builds)
  • Processor: 64-bit x86
  • Disk: 30GB
  • OS: UNIX compatible (OS X, most flavors of Linux)

1. Setup System Environment

MOOSE requires a 64 bit operating system.
Select your operating system to view the setup instructions.

2. Clone MOOSE

MOOSE is hosted on GitHub and can be cloned directly from there using Git. We recommend creating a directory named projects to put all of your MOOSE related work in which leads to the following commands (from your home directory):

mkdir ~/projects
cd ~/projects
git clone
cd ~/projects/moose
git checkout master

Note: The "master" branch of MOOSE is the "stable" branch that will only be updated after all tests are passing. This protects you from the day-to-day churn in the MOOSE repository.

3. Compile libMesh

MOOSE directly relies on the libMesh finite-element framework. Because of this strong tie MOOSE actually contains a particular version of libMesh that we have vetted for our users. We will periodically update that version (about once a month) so stay tuned to the MOOSE-users mailing list for those announcements.

To pull down and compile this version of libMesh you simply need to run a script in MOOSE:

cd ~/projects/moose

Note: Do not use sudo when running the above script.

This will automatically pull down the verified version of libMesh and compile it.

4. Test It!

All that's left is to make sure that everything is working properly...

cd ~/projects/moose/test
make -j8
./run_tests -j8

If everything is good then all of the tests will pass. Note: Some will be skipped depending on your environment.

5. Stay Engaged! Stay Up to Date!

Join one of our mailing lists: - Technical Q&A (moderate traffic) - Announcements (very light traffic)

GMail Users: Just click the "Join group" button

Everyone else: Send an email to: or

Update your copy of MOOSE for the latest features and fixes.

cd ~/projects/moose
git fetch origin
git rebase origin/master

Create an App

Creating your very own MOOSE application is a cinch: you do it by running our stork script... which generates a skeleton application, just follow the instructions for creating an application, and check out our list of tutorials.

Get Social!

At this point you definitely want to join the moose-users mailing list.

And finally—why not tell the world how your install went by hitting the Twitter button on the right?

You may also want to follow the MOOSE developers on Twitter:

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