Install from Source (Debian, Ubuntu)
These instructions outline how to install an all in one Opencast system on Ubuntu 12.04 with LTS.
Create a dedicated Opencast user.
useradd -d /opt/matterhorn matterhorn
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 do not have to download nearly as much as with Git.
Using the tarball:
Select the tarball for the version you want to install from https://bitbucket.org/opencast-community/matterhorn/downloads#tag-downloads
# Download desired tarball curl -O https://bitbucket.org/opencast-community/matterhorn/... tar xf develop.tar.gz mv opencast-community-matterhorn-* /opt/matterhorn/
Cloning the Git repository:
git clone https://bitbucket.org/opencast-community/matterhorn.git cd opencast git tag <- List all available versions git checkout TAG <- Switch to desired version
Please make sure to install the following dependencies. Note that not all dependencies are in the system repositories.
openjdk-7-jdk or openjdk-8-jdk ffmpeg >= 2.5 maven >= 3.1
Note that by default Ubuntu and Debian ship Libav and installing the
ffmpegpackage from the default repository will not get you FFmpeg. If you are unsure about where to get FFmpeg, please refer to the FFmpeg website.
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
Pre-built versions of most dependencies that are not in the repositories can be downloaded from the respective project website:
Make sure everything belongs to the user
matterhorn (you may choose a different name):
sudo chown -R matterhorn:matterhorn /opt/matterhorn
Switch to user
sudo su - matterhorn
Compile the source code:
cd /opt/matterhorn mvn clean install -DdeployTo=/opt/matterhorn
Please follow the steps of the Basic Configuration guide. It will help you to set your hostname, login information, …
Install Opencast start script and man-page for installations in
cd /opt/matterhorn/docs/scripts/init/opt sudo ./install.sh
This will install the start script along with either a SysV-Init script or a systemd unit file.
Now you can start Opencast by running
sudo matterhorn --interactive
Browse to [http://localhost:8080] to get to the admin interface.
Run Opencast as Service
Usually, you do not want to run Opencast in interactive mode but as system service to make sure Opencast is run only once on a system and is started automatically.
# Start Opencast sudo service matterhorn start # Autostart after reboot sudo chkconfig --level 345 matterhorn on
# Start Opencast sudo systemctl start matterhorn # Autostart after reboot sudo systemctl enable matterhorn