Toggle Menu


Colosseum Configuration

Cloudiator features a central point of configuration: the configuration file of Colosseum. It contains all default configuration options, that can be overwritten by supplying an addition configuration file using the -Dconfig.file parameter when starting Colosseum. While directly changing the file is also possible it is not recommended.

This new configuration file should at least contain the following information:

include "application.conf"

# Secret key
# ~~~~~
# The secret key is used to secure cryptographics functions.
# If you deploy your application to several instances be sure to use the same key!
play.crypto.secret = "A_VERY_SECRET_KEY"

# Database configuration
# ~~~~~
db.default.driver = org.mariadb.jdbc.Driver
db.default.url = "mysql://dbuser:dbpassword@dbhost/dbname"

colosseum.nodegroup = "cloudiator-nodegroup"

Configuration Option Description
play.crypto.secret Application Secret
db.default.driver The jdbc driver for the database. By default only the MariaDB driver is present. Can be used for MariaDB and MySQL.
db.default.url The jdbc connection string
colosseum.nodegroup A unique identifier for this installation of Cloudiator. Should not be to long. Should only contain - and alphanumeric characters.

The installation routine automatically generates a configuration file, generating an application secret and configuring the database and the colosseum.nodegroup.

Other configuration options

All other configuration options can be changed by simply overwriting an existing value in the configuration file. All default configuration values, can be found in the Colosseum configuration file.

Configuring Sword

While our cloud abstraction framework tries to be as generic as possible, trying to automatically detect most configuration options, there may be situations where you need to adapt the configuration to your cloud. Cloudiator offers two possibilities to configure those properties:

  • a global configuration in the colosseum configuration file
  • a per cloud configuration per API

All configuration parameters can be seen in the Sword docs.


When setting a global configuration option, this is valid for all clouds. This means if you set a property for the openstack-nova driver of Sword, this property will be valid for all currently used clouds using the openstack-nova driver.

A global configuration option can be set in the Colosseum configuration file.

The syntax is + the Sword property you want to set. The example below globally configures the sword.ec2.ami.query option. = "state=available;image-type=machine;"


The settings can also be set on a per-cloud basis, meaning that the property will only affect this specific cloud. For this purpose the entity CloudProperty can be used.


Cloud cloud;
String key = sword.ec2.ami.query;
String value = "state=available;image-type=machine;"

                    new CloudPropertyBuilder().cloud(cloud.getId()).key(key)


POST /api/cloudProperty

    "cloud": 1,
    "key": "sword.ec2.ami.query",
    "value": "state=available;image-type=machine;"