Install from Source (Mac OS X)

These instructions outline how to install an all in one Opencast system 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.


Open a Terminal and switch to the directory, in which the Opencast installation should be placed, e.g. /opt/, ~/develop/ or whatever you prefer.

Get Opencast source

You can get the Opencast 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.

Cloning the Git repository:

git clone
cd opencast
git tag   <-  List all available versions
git checkout TAG   <-  Switch to desired version

Using the tarball:

Select the tarball for the version you want to install from the GitHub releases section under the "Tags" tab and download it directly from there or with the curl command specified below.

# Download desired tarball, replace [...] with the desired version
curl -OL[...].tar.gz
tar xf [...].tar.gz

Install Dependencies

Please make sure to install the following dependencies.


jdk 8
ffmpeg >= 3.2.4
maven >= 3.1
python >= 2.6, < 3.0

Required (not necessarily on the same machine):

ActiveMQ >= 5.10 (older versions untested)

Required for text extraction:

tesseract >= 3

Required for hunspell based text filtering:

hunspell >= 1.2.8

Required for audio normalization:

sox >= 14.4 (with MP3, FLAC and OGG support)

Required for animate service:


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

brew install tesseract
brew install hunspell
brew install sox --with-lame --with-flac --with-libvorbis

Using pre-built binaries

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

Building Opencast

Switch to the opencast folder. If you downloaded the tarball, this is the folder you just unpacked (called something like opencast-community-opencast-[…]). If you chose to download via git, use cd opencast. You can proceed by building opencast (depending on the folder permissions, you might need to start the command with sudo):

mvn clean install

Please be patient, as building Opencast 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. Be aware that the config files now reside in the build folders for the desired distribution. For the allinone distribution, this would be /your/path/to/opencast/build/opencast-dist-allinone-[…]/etc/, again with […] representing the selected version.

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-opencast script:

activemq start
cd /your/path/to/opencast/
cd build/opencast-dist-allinone-[…]

As soon as Opencast is completely started, browse to http://localhost:8080 to get to the administration interface.