Close

22nd July 2020

Download v8 | Source Pack

The source code of OpenFOAM 8 and related third-party software can be downloaded as tar.gz compressed archive files:

The archive files download with inconvenient file names, so we recommend following the instructions below where they are unpacked immediately into the source directories, which avoids storing the files themselves.

Tested Platforms

OpenFOAM is developed and tested on Linux, and should work with any recent distribution of GNU/Linux. OpenFOAM-8 and ThirdParty-8 have been tested on the following Linux distributions:

  • Ubuntu 16.04 (xenial), 18.04 (bionic), 20.04 (focal)
  • OpenSuSE Tumbleweed (June 2020)
  • Centos 7

Unpacking the Sources

The user should choose a directory location to unpack these files, which will become the installation directory of OpenFOAM. If the installation is for a single user only, or if the user does not have root access to the machine, we would recommend the installation directory is $HOME/OpenFOAM (i.e. a directory OpenFOAM in the user’s home directory). If the installer has root permissions and the installation is for more than one user, one of the ‘standard’ locations can be used, e.g. /usr/local/OpenFOAM, /opt/OpenFOAM, or just /opt.

After the installation directory is chosen (and, if necessary, created), open a terminal window, change into the installation directory and download an unpack the source and third-party archives by copying and pasting the following:

wget -O - http://dl.openfoam.org/source/8 | tar xvz
wget -O - http://dl.openfoam.org/third-party/8 | tar xvz

The files unpack to produce directories OpenFOAM-8-version-8 and ThirdParty-8-version-8, which need to be renamed as follows:

mv OpenFOAM-8-version-8 OpenFOAM-8
mv ThirdParty-8-version-8 ThirdParty-8

Software for Compilation

Follow the instructions for installing Software for Compilation of OpenFOAM for your platform.

Setting Environment Variables

The environment variable settings are contained in files in an OpenFOAM-8/etc directory in the OpenFOAM release. e.g. $HOME/OpenFOAM/OpenFOAM-8/etc for the case where the installation is in $HOME/OpenFOAM:

The user should configure their system with permanent settings to source the environment. If OpenFOAM is installed in the $HOME/OpenFOAM directory, the user should:

EITHER

if running bash or ksh (if in doubt type echo $SHELL), source the etc/bashrc file by adding the following line to the end of your $HOME/.bashrc file:

source $HOME/OpenFOAM/OpenFOAM-8/etc/bashrc

then type “source $HOME/.bashrc” in the current terminal window

OR

if running tcsh (avoid csh, which can have compatibility issues) source the etc/cshrc file by adding the following line to the end of your $HOME/.cshrc file:

source $HOME/OpenFOAM/OpenFOAM-8/etc/cshrc

then type “source $HOME/.cshrc” in the current terminal window.

When OpenFOAM is installed in an alternative directory, e.g. /opt, the user should substitute $HOME/OpenFOAM with the relevant installation location in the lines above.

Installing Third-Party Software

Follow the instructions for installing Third Party Software on your platform.

Compiling OpenFOAM

With the Third Party software installed and environment updated, compile OpenFOAM by going into the OpenFOAM-8 directory and executing the Allwmake script.  Type Allwmake -help for options, but the 2 main choices are to compile in serial with

./Allwmake

or compile in parallel with all available cores/hyperthreads with:

./Allwmake -j

Serial compilation takes several hours, whereas compilation on 8 cores/threads should take approximately one hour, possibly less, depending on the processor.

Getting Started

Create a project directory within the $HOME/OpenFOAM directory named <USER>-8 (e.g. chris-8 for user chris and OpenFOAM version 8) and create a directory named run within it, e.g. by typing:

mkdir -p $FOAM_RUN

Copy across the backward facing step example, generate the mesh with blockMesh and run the steady flow, incompressible solver simpleFoam

cd $FOAM_RUN
cp -r $FOAM_TUTORIALS/incompressible/simpleFoam/pitzDaily .
cd pitzDaily
blockMesh
simpleFoam
paraFoam

Refer to the OpenFOAM User Guide to get started.

Reporting Bugs in OpenFOAM

We appreciate that bugs in OpenFOAM are reported so we can fix them. Please refer to the OpenFOAM bugs pages to report bugs.