Install from Source (Mac OS X)

This document will help you install and run Matterhorn on the Mac OS X operating system. Tested on OS X 10.9 Mavericks.

The installation on Mac OS X is not officially supported. Use this at your own risk.


Create Matterhorn installation directory

sudo mkdir -p /opt/matterhorn
sudo chown $USER:$GROUPS /opt/matterhorn

Check out Matterhorn source

You can get the Matterhorn source code by either downloading a tarball of the source code or by cloning the Git repository. The latter option is more flexible, it is easier to upgrade and in general preferred for developers. The prior option, the tarball download, needs less tools and you don't have to download nearly as much as with Git.

Using the tarball:

Select the tarball for the version you want to install from

# Download desired tarball
curl -O
tar xf develop.tar.gz
mv opencast-community-matterhorn-* /opt/matterhorn/

Cloning the Git repository:

cd /opt
git clone
cd opencast
git checkout r/2.0.x

Install Dependencies

Please make sure to install the following dependencies.


jdk 7 or jdk 8
ffmpeg >= 2.5
maven >= 3.1

Required (not necessarily on the same machine):

ActiveMQ >= 5.10 (older versions untested)

Required for text extraction (recommended):

tesseract >= 3

Required for hunspell based text filtering (optional):

hunspell >= 1.2.8

Required for audio normalization (optional):

sox >= 14.4

Dependency Download

You can download Xcode in the Mac App Store. JDK 8 for OS X is available from Oracle.

Using Homebrew

Homebrew is a package manager for OS X. For installation instruction see their website.

brew install maven
brew install ffmpeg
brew install apache-activemq
# Optional
brew install tesseract
brew install hunspell
brew install sox

Using pre-built binaries

Pre-built versions of most dependencies can be downloaded from the respective project website:

Building Opencast

Compile the source code:

cd /opt/matterhorn
mvn clean install -DdeployTo=/opt/matterhorn

Please be patient, as building matterhorn for the first time will take quite long.


Please follow the steps of the Basic Configuration guide. It will help you to set your host name, login information, etc. As specified in the guide, make sure you replace the default ActiveMQ configuration with the one provided in docs/scripts/activemq/activemq.xml. If you installed ActiveMQ using homebrew, you can find the installation path with brew info activemq.

Running Opencast

Make sure you have ActiveMQ running (unless you're running it on a different machine). Then you can start Opencast using the start-matterhorn script.

activemq start
cd /opt/matterhorn
sudo ./bin/start-matterhorn