Fractal Server Config

This page documents the valid options for the YAML file inputs to the Config File. This first section outlines each of the headers (top level objects) and a description for each one. The final file will look like the following:

common:
    option_1: value_for1
    another_opt: 42
server:
    option_for_server: "some string"

Command Invocation

qcfractal-server config [<options>]

Command Description

Show the current config file at an optional location.

Looks in the default location if no arg is provided

Options

--base-folder [<folder>]

The QCFractal base directory to attach to. Default: ~/.qca/qcfractal

Config File Complete Options

The valid top-level YAML headers are the parameters of the FractalConfig class.

class qcfractal.config.FractalConfig(**kwargs)[source]

Top level configuration headers and options for a QCFractal Configuration File

Parameters

  • base_folder (str, Default: /home/docs/.qca/qcfractal) – The QCFractal base instance to attach to. Default will be your home directory

  • database (DatabaseSettings, Optional)

  • view (ViewSettings, Optional)

  • fractal (FractalServerSettings, Optional)

database

class qcfractal.config.DatabaseSettings[source]

Postgres Database settings

Parameters

  • port (int, Default: 5432) – The postgresql default port

  • host (str, Default: localhost) – Default location for the postgres server. If not localhost, qcfractal command lines cannot manage the instance.

  • username (str, Optional) – The postgres username to default to.

  • password (str, Optional) – The postgres password for the give user.

  • directory (str, Optional) – The physical location of the QCFractal instance data, defaults to the root folder.

  • database_name (str, Default: qcfractal_default) – The database name to connect to.

  • logfile (str, Default: qcfractal_postgres.log) – The logfile to write postgres logs.

  • own (bool, Default: True) – If own is True, QCFractal will control the database instance. If False Postgres will expect a booted server at the database specification.

fractal

class qcfractal.config.FractalServerSettings[source]

Fractal Server settings

Parameters

  • name (str, Default: QCFractal Server) – The QCFractal server default name.

  • port (int, Default: 7777) – The QCFractal default port.

  • compress_response (bool, Default: True) – Compress REST responses or not, should be True unless behind a proxy.

  • allow_read (bool, Default: True) – Always allows read access to record tables.

  • security (str, Optional) – Optional user authentication. Specify ‘local’ to enable authentication through locally stored usernames. User permissions may be manipulated through the qcfractal-server user CLI.

  • query_limit (int, Default: 1000) – The maximum number of records to return per query.

  • logfile (str, Default: qcfractal_server.log) – The logfile to write server logs.

  • service_frequency (int, Default: 60) – The frequency to update the QCFractal services.

  • max_active_services (int, Default: 20) – The maximum number of concurrent active services.

  • heartbeat_frequency (int, Default: 1800) – The frequency (in seconds) to check the heartbeat of workers.

  • log_apis (bool, Default: False) – True or False. Store API access in the Database. This is an advanced option for servers accessed by external users through QCPortal.

  • geo_file_path (str, Optional) – Geoip2 cites file path (.mmdb) for resolving IP addresses. Defaults to [base_folder]/GeoLite2-City.mmdb

view

class qcfractal.config.ViewSettings[source]

HDF5 view settings

Parameters

  • enable (bool, Default: True) – Enable frozen-views.

  • directory (str, Optional) – Location of frozen-view data. If None, defaults to base_folder/views.