Configuration

Configuration for Oliver is stored in the config file as JSON. By default, the dotfile is location at ~/.oliver_config. One of the benefits of using Oliver is the "set and forget" nature of configuration. For instance, a common configuration option that you might want to set rather than providing on the command line is the URL to your Cromwell server.

Basics

Before using Oliver, you should run the configuration quickstart wizard:

oliver configure

If you just want to accept the defaults, or if you are using Oliver in a non interactive environment like CI, you can just start with the default configuration.

oliver configure --defaults

Similarly, you can use the oliver config subcommand to display current config values, get specific key-value pairs, or set new values for configuration options.

# list all config values
oliver config list

# get a particular key
oliver config get cromwell_server

# set a particular key's value
oliver config set cromwell_server http://foo:8000

Commonly Used Options

The following key values pairs are commonly used to configure Oliver. Note that any key in the argparse parser can be specified in the configuration — if you would like to set any of these options and don't mind looking through Python code, you can do so (we do not exhaustively list all possible config options here).

Key Description Type Default
cromwell_server HTTP/HTTPS root URL for the Cromwell server to use by default. String http://localhost:8000
cromwell_api_version Cromwell API version to use by default. String v1
batch_interval_mins When inferring batches, how many minutes should separate two batches? Int 2
output_prefix Prefix to append to file locations. String None

Cromwell on Azure Specific

Key Description Type Default
azure_resource_group If using Cromwell on Azure, resource group associated with your Cromwell instance. String
cosmos_account_name If using Cromwell on Azure, name of CosmosDB associated with your Cromwell instance. String