Configuration Files and Keys

This document will help you get an overview of the existing Matterhorn configuration files and watch folders.

Watch Folders

Watch folders allow you to quickly augment Matterhorn's existing behavior, simply by adding new configuration files. Below is a list of default watch folders.

Encoding Profiles

Default and custom encoding profiles should be placed in /etc/encoding. The file names should follow the pattern *.properties.

Atom and RSS Feeds

Default and custom feed definitions should be placed in /etc/feeds. The file names should follow the pattern *.xml.

Workflow Definitions

Custom workflow definitions should be placed in /etc/workflows. The file names should follow the pattern *.xml.

OSGi Bundles

Additional OSGi bundles should be placed in /lib/matterhorn. /etc/load should be reserved for the default configuration.


Media files placed in /inbox will be copied to the Matterhorn working file repository and made available in the Admin Tools > Uploading Recording user interface, via the File Location menu.

Queued media files are write-protected, copied to the working file repository and then deleted from the inbox.

Configuration Files

Configuration files use key-value pairs to determine Matterhorn's runtime behavior.

/etc/ is the primary Matterhorn configuration file.

Bundle Configuration Properties

Name Description Default
org.osgi.service.http.port Port number of http services 8080 Port number of https services 8443 Toggle https services false

Alternatively, edit Apache's httpd.conf to reroute Matterhorn to port 80:

ProxyPass / http://localhost:8080/
ProxyPassReverse / http://localhost:8080/

Opencast Matterhorn Configuration

Name Description Default
org.opencastproject.server.url URL of Matterhorn http services http://localhost:8080 e.g. org.opencastproject.server.url=
org.opencastproject.serviceregistry.url URL of the service registry, if not running in the local JVM This value is needed only if the host does not have access to the relational database (see JDBC settings below). This is common for capture agents, but not for servers.
org.opencastproject.server.maxload The maximum number of concurrent jobs this server should attempt to run Defaults to the number of processing cores available to the JVM, as reported by Runtime.availableProcessors() Base path of Matterhorn data file structure. Note: This must be changed on a production server so that media will not disappear on reboot. ${}/opencast Path to Matterhorn security configuration file conf/security.xml Digest authentication privileged user name matterhorn_system_account Digest authentication privileged user password CHANGE_ME The project-wide feedback service, used to help the community understand how Matterhorn is deployed "in the wild. For more information on this feature, see the Project Feedback Service documentation No Feedback
Name Description Default
org.opencastproject.streaming.url URL of Red5 streaming server rtmp://localhost/matterhorn-engage Path to published streaming media ${}/streams
org.opencastproject.streaming.flvcompatibility Some newer streaming server versions expect an "flv:" tag within the rtmp URL. Not every RTMP-streaming server is compatible with this (i.e. nginx), so this is the compatibility mode to the old syntax. true = without "flv:" tag - old syntax, false = with "flv:" tag - new syntax false
Name Description Default
org.opencastproject.db.ddl.generation Toggle generation of database description language true
org.opencastproject.db.vendor Database vendor type HSQL
org.opencastproject.db.jdbc.driver Fully-qualified name of database adapter org.h2.Driver
org.opencastproject.db.jdbc.url URL of database, using the jdbc::// protocol jdbc:h2:${}/db;LOCK_MODE=1;MVCC=TRUE
org.opencastproject.db.jdbc.user Privileged database user name sa
org.opencastproject.db.jdbc.pass Privileged database user password sa
Name Description Default Path to published progressive media ${}/downloads
Name Description Default Path to search index files ${}/searchindex
Working File Repository
Name Description Default
org.opencastproject.file.repo.path Path to Matterhorn working file repository ${}/files
Name Description Default
org.opencastproject.workspace.rootdir Path to the workspace root directory ${}/workspace
Name Description Default
org.opencastproject.workflow.default.definition ID of default workflow definition full
org.opencastproject.workflow.solr.dir If using a local workflow search index, this is the directory to use for storage of the embedded solr server's index files ${}/workflow
org.opencastproject.workflow.solr.url If using a remote workflow search index, this is the URL to the remote solr server. Configure either this value or org.opencastproject.workflow.solr.dir but not both.
Name Description Default
org.opencastproject.inbox.threads The number of mediapackages to ingest concurrently from the watch folder 1


org.opencastproject.organization-mh_default_org.cfg defines the default tennant in a multi tennant setup. If you don't have a multi-tennant setup this is the file for you to edit.

Servers and URLs

Name Description Default The URL to the administrative tools. This sets the URL for the "Adminstrative Tools" link on the Matterhorn welcome page. The local server URL, or ${org.opencastproject.server.url} The URL to the engage tools. This sets the URL for the "Engage Tools" link on the Matterhorn welcome page. The local server URL, or ${org.opencastproject.server.url}



mh_default_org.xml defines the Matterhorn access policy using the Spring Security framework XML schema.