Configuration¶

This page helps you to configure Cloudgene and describes all parameters of the settings.yamlfile. When you change a parameter in the file, you have to restart your Cloudgene instance to see the change in action.

Database connection¶

Cloudgene uses an embedded H2 database to store meta data about jobs and users:

database:
  driver: h2
  database: data/cloudgene
  user: cloudgene
  password: cloudgene

For production we recommend to use a MySQL database:

database:
  driver: mysql
  host: localhost
  port: 3306
  user: cloudgene
  password: cloudgene

Mail Server¶

If no mail server is set, new registered users are activated immediately and no confirmation links are sent. This can be activated by defining a local or remote SMTP mail server:

mail:
  smtp: localhost
  port: 25
  user: username
  password: password
  # the email address that Cloudgene uses to send emails
  name: noreply@domain.com

Web-Application¶

Change the name of your service. If you plan to run Cloudgene on a sub-directory, then you can change the url-prefix.

# the name of your service [default: Cloudgene]
name: My Service
# port [default: 8082]
port: 8082
# max file size that can be uploaded in Bytes. -1 is unlimited [deafult: -1]
uploadLimit: 50000
# server name
serverName: "https://localhost:8082"
# base url of the web-application [default: empty]
baseUrl: /my-service

Security¶

Please change the secretKey to generate JWT tokens:

# use this secret key to generate JWT tokens.
# please use a secret random string
secretKey: some-random-string

Directories and Workspace¶

If your service produces a lot of data, it could be useful to set the workspace directories to an other disc. The following directories can be changed:

# location for temporary files (e.g. cached file uploads) [default: tmp]
tempPath: tmp
# location for the results of a job [default: workspace]
localWorkspace: /mnt/new-disc/workspace

Downloads¶

For security reasons, files can be downloaded 10 times. Users will get an error message, when this number is succeeded. The maximal number of downloads can be increased or set to -1 in order to allow unlimited downloads:

# max number of downloads [default: 10]
# use -1 for unlimited downloads
maxDownloads: 10

Download counters can also be deactivated for specific jobs in the Admin Panel.

Queue¶

Cloudgene manages two different queues to execute setup steps and workflow steps for a job. The number of jobs which are executed in parallel can be set for each queue independently:

# max. n jobs can execute their setup steps in parallel [default: 5]
threadsSetupQueue: 5
# max. n jobs can execute their workflow steps in parallel  [default: 5]
threadsQueue: 5
# each user can run max. n jobs at the same time  [default: 2]
maxRunningJobsPerUser: 2

Auto-Retire¶

To change the default values please adapt the following parameters in your settings.yaml file:

# retire jobs after x days [default: 6]
retireAfter: 6
# sent notification after x days [default: 4]
notificationAfter: 4
# perform retire as a cronjob [default: false].
autoRetire: true
# perform retire cronjob every x hours [default: 5].
autoRetireInterval: 5

Important

If autoRetire is set to false, you have to click on the Retire button in Administrator Dashboard to clean up.