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