Basic Configuration

This guide will help you to change the basic configuration settings which are required or at least strongly recommended for each Opencast installation. This is basically what you should do, right after installing Opencast on your machine.

All settings are made to files residing in the Opencast configuration directory. In most cases, that should be either /etc/opencast/ or /opt/opencast/etc/. Edit the files using the editor of your choice, e.g.:

vim /etc/opencast/

Step 1: Setting the Server URL

By default, only connections from the local machine are accepted by Opencast. You want to change this if the system should be accessible within a network.

First, find the property org.opencastproject.server.url in your configuration file and set it to your own domain name:


Note: This value will be written to all generated mediapackages and thus cannot be changed easily for already processed media. At least not without an extra amount of work involving modifications to the database. That is why you should think about this setting carefully.

Second, adjust the binding address in your org.ops4j.pax.web.cfg configuration file. The binding address can be set to for general network access. The property to modify is:


It may be necessary to adjust the jetty http connector idleTimeout value for processing large files in some configurations. To do so, uncomment this line in org.ops4j.pax.web.cfg:


and modify the host and if necessary port values in jetty-opencast.xml to match the ops4j configuration:

<Set name="host"></Set>

Step 2: Setting the Login Details

There are two authentication methods for Opencast. HTTP Digest authentication and form-based authentication. Both methods need a username and a password. Change the password for both! The important keys for this are:

Note: The digest credentials are also used for internal communication of Opencast servers. So these keys have to be set to the same value on each of you Opencast nodes (Core, Worker, Capture Agent, …)

Step 3: Change the default shutdown command

Karaf provides a socket over wich you can send a shutdown command. The socket does not provide any kind of authentication. Therefore anyone who obtains write access to this socket is able to shutdown karaf and everything that runs on it. There is a default karaf.shutdown.command defined in Change this to something secret.

Step 4: Setting up Apache ActiveMQ Message Broker

Since version 2.0, Opencast requires a running Apache ActiveMQ instance with a specific configuration. The message broker is mostly run on the admin server of Opencast but can be run separately. It needs to be started before Opencast. For more details about the setup, have a look at the Apache ActiveMQ configuration guide.

Step 5: Database Configuration

Opencast uses an integrated HSQL database by default. While you will find it perfectly functional, it has certain drawbacks:

For testing, it is totally fine to keep the internal database, but you are highly encouraged to switch to a stand-alone database for productional use. For more information about database configuration, have a look at the Database Configuration section.

Step 6: Setting the Storage Directory (optional)

Even though it is not important for all systems – on test setups you can probably omit this – you will often want to set the storage directory. This directory is used to store all media, metadata, … Often, an NFS mount is used for this. You can set the directory by changing like:

Please keep in mind that the user running Opencast must have read/write permissions to the storage directory.