This page documents the installation of the Dynare on Mac OS X. If you have any troubles, please contact <houtan AT SPAMFREE dynare DOT org>

Install Dynare (Stable)

Dynare for Matlab

1. Download the appropriate Dynare package for your version of Mac OS X from the Dynare website

2. Install Dynare by double-clicking on the package and following the installation instructions.
   1. If you get a warning saying that the package cannot be opened "because it is from an unidentified developer," open the folder containing the package, right-click on it, select "Open" from the menu that pops up, and select "Open" from the dialog box that pops up.

3. The default installation folder is /Applications/Dynare/<<version>>, where <<version>> is one of 4.2.0, 4.2.1, 4.2.2, etc.

Dynare for Octave (Stable)

1. Install Homebrew by following the directions on their site

2. Tap Homebrew-Science

   1. brew tap homebrew/science

3. Look at the available installation options by typing brew info dynare at the terminal prompt

4. Install Dynare, passing the options you require for your setup
   1. E.g., to install Dynare with support for Octave and Matlab 2014b and avoid testing the compiled files, you would type the following at the command prompt:

   2. brew install dynare --with-matlab=/Applications/MATLAB_R2014b.app --with-matlab-version=8.4 --without-check

   3. NB: We encourage you to always pass the --without-check option

5. The default installation folder is ls /usr/local/Cellar/dynare/<<version>>, where <<version>> is one of 4.2.0, 4.2.1, 4.2.2, etc.

Install Dynare (Unstable)

Via the snapshot (Provides Matlab mex files)

1. Follow the instructions above using the latest Dynare snapshot for macOS

Via Homebrew (provides Matlab and Octave mex files)

1. Install Homebrew by following the directions on their site

2. Tap Homebrew-Science

   1. brew tap homebrew/science

3. Look at the available installation options by typing brew info dynare at the terminal prompt

4. Install Dynare, passing the options you require for your setup
   1. E.g., to install Dynare with support for Octave and Matlab 2014b and avoid testing the compiled files, you would type the following at the command prompt:

   2. brew install dynare --HEAD --with-matlab=/Applications/MATLAB_R2014b.app --with-matlab-version=8.4 --without-check

   3. NB: We encourage you to always pass the --without-check option

5. The default installation folder is ls /usr/local/Cellar/dynare/<<version>>, where <<version>> is one of 4.2.0, 4.2.1, 4.2.2, etc.

Setup Matlab/Octave to use Dynare

Dynare (stable) on Mac OS X 10.6 or higher

MATLAB Setup

1. Add /Applications/Dynare/<<version>>/matlab/ to your Matlab path. You can do this either using the addpath command to add it just for this session or using the menu option File->Set Path... to add it across Matlab sessions.

Octave Setup

1. Having installed Octave via Homebrew, open Octave by typing octave at the terminal prompt.

2. At the Octave prompt, type: addpath /usr/local/opt/dynare/lib/dynare/matlab

Dynare 4.3.3 - 4.4.2 on Mac OS X 10.6 or higher

MATLAB Setup

1. Add /Applications/Dynare/<<version>>/matlab/ to your Matlab path. You can do this either using the addpath command to add it just for this session or using the menu option File->Set Path... to add it across Matlab sessions.

Octave Setup

1. Install Octave 3.6.4 via Homebrew (which requires XCode) by following the instructions in the "Simple Installation Instructions" subsection of the "Homebrew" section of this site.

2. Before executing MOD files, you need to execute the following command at Octave prompt:

   addpath /Applications/Dynare/<<version>>/matlab

Dynare 4.2.2 - 4.3.2 on Mac OS X 10.6 or higher

MATLAB Setup

1. Add /Applications/Dynare/<<version>>/matlab/ to your Matlab path. You can do this either using the addpath command to add it just for this session or using the menu option File->Set Path... to add it across Matlab sessions.

Octave Setup for OS X 10.6 and 10.7 (not available under 10.8)

1. Download and install version 3.4.0 of the Octave Mac OS X binary and add /Applications/Octave.app/Contents/Resources/bin to your search path.

2. If you are going to use the use_dll or k_order_perturbation options, add the following lines to the /Applications/Octave.app/Contents/Resources/bin/mkoctfile-3.4.0 file after the set -e statement at the top of the file

   CFLAGS="-arch i386 ${CFLAGS}"
   FFLAGS="-arch i386 ${FFLAGS}"
   CPPFLAGS="-arch i386 ${CPPFLAGS}"
   CXXFLAGS="-arch i386 ${CXXFLAGS}"
   LDFLAGS="-arch i386 ${LDFLAGS}"

3. Before executing MOD files, you need to execute the following command at Octave prompt:

   addpath /Applications/Dynare/<<version>>/matlab

Dynare 4.2.0 or 4.2.1 on Mac OS X 10.5 or 10.6

MATLAB Setup

1. Install XCode 3.2 or later, which can either be installed from the internet or from the installation discs that came with your Mac. This installs the necessary gcc compilers required by build_dynare.m in step 3.

2. In Matlab, change directory to the root folder of the Dynare installation directory. In the standard installation, you need to do:

   >> cd /Applications/Dynare/<<version>>

3. At the Matlab prompt, run

   >> build_dynare

4. Once this has finished running, go to File->Set Path... and add the path to the matlab/ subfolder under the installation folder. In the standard installation, this will be /Applications/Dynare/<<version>>/matlab. Save the changes before closing the window.

Octave Setup

1. Download and install version 3.2.3 of the Octave Mac OS X binary and add /Applications/Octave.app/Contents/Resources/bin to your search path.

2. If you are going to use the use_dll or k_order_perturbation options, add the following lines to the /Applications/Octave.app/Contents/Resources/bin/mkoctfile-3.2.3 file after the set -e statement at the top of the file

   CFLAGS="-arch i386 ${CFLAGS}"
   FFLAGS="-arch i386 ${FFLAGS}"
   CPPFLAGS="-arch i386 ${CPPFLAGS}"
   CXXFLAGS="-arch i386 ${CXXFLAGS}"
   LDFLAGS="-arch i386 ${LDFLAGS}"

3. Before excuting MOD files, you need to execute the following command at Octave prompt:

   addpath /Applications/Dynare/<<version>>/matlab

Documentation

Documentation can be found in the doc/ folder under the installation directory (the default is /Applications/Dynare/<<version>>/doc). The User Guide (located by default in /Applications/Dynare/<<version>>/doc/userguide/UserGuide.pdf) is a particularly helpful starting place. Errata for the User Guide can be found here.