# `deriva-web` Configuration Guide The service uses two files for configuration: `deriva_config.json` for service specific configuration and `wsgi_deriva.conf` to configure WSGI module support in Apache HTTPD. ### deriva_config.json The installation and deployment process creates a `deriva` user on the local system, including a home directory for this user. The service-specific configuration file `deriva_config.json` is located in this directory. Below is a sample of the default configuration file: ```json { "storage_path": "/var/www/deriva/data", "authentication":"webauthn", "404_html": "

Resource Not Found

The requested resource could not be found at this location.

Additional information:

%(message)s

", "403_html": "

Access Forbidden

%(message)s

", "401_html": "

Authentication Required

%(message)s

", "400_html": "

Bad Request

One or more request parameters are incorrect.

Additional information:

%(message)s

" } ``` * The `storage_path` variable is an absolute path to the base directory where the service stores file data. * The `authentication` variable is an optional string value representing the authentication mechanism to use. Valid values are `"webauthn"` or `None`, or the key can be ommitted, which is equivalent to specifiying `None`. * The various `"*_html"` variables are for specifying customized HTML error template responses for API functions. ### wsgi_deriva.conf The `wsgi_deriva.conf` file is installed to `/etc/httpd/conf.d`. Below is an example of the default: ``` # this file must be loaded (alphabetically) after wsgi.conf AllowEncodedSlashes On WSGIPythonOptimize 1 WSGIDaemonProcess deriva processes=8 threads=4 user=deriva maximum-requests=2000 WSGIScriptAlias /deriva /usr/lib/python2.7/site-packages/deriva/deriva.wsgi WSGIPassAuthorization On WSGISocketPrefix /var/run/httpd/wsgi AuthType webauthn Require webauthn-optional WSGIProcessGroup deriva SetEnv dontlog ```