Configure the application

After you deploy the Metadata Capture application, configure it to work in your environment. The application uses a configuration file to manage key settings such as feature flags, database connections, and authentication.

Configure the application settings to work in your environment by editing and mounting the configuration file.

1. Open the configuration file located at /app/config.json in your Docker container.

   Default settings

   To see the default configuration, download the default config.json file from the repository.

2. Modify the settings in the config.json file to match your environment. Key settings include:

   • Application settings: Configure app_title and catalogue information (name, description, publisher).
   • Feature flags: Enable or disable features and other functionality flags.

3. Configure the different aspects of the application:

   • Set up authentication: Configure your OpenID Connect (OIDC) provider.
   • Configure roles and permissions: Define your organisation's roles and their permissions.
   • Configure email notifications: Set up SMTP and manage notification templates.
   • Configure UI content: Set default UI messages and manage their overrides.
   
   
   Schema reference

   For details on the available settings and their expected values and formats, refer to the configuration schema.

4. Mount the configuration file to make your changes persistent. Use either Docker Compose or the docker run command:

   If you are using Docker Compose:

   services:
     app:
       environment:
         - CONFIG_PATH=/app/config.json
       volumes:
         - ./path/to/custom/config.json:/app/config.json

   If you are using Docker run:

   docker run -v $(pwd)/path/to/custom/config.json:/app/config.json <your-app-name> -e CONFIG_PATH=/app/config.json

Configure the Health Data Access Body

If your deployment supports health datasets (HealthDCAT-AP), configure the Health Data Access Body (HDAB) details. This information appears in the health metadata section of published dataset records and is used as a reference contact for health data access queries.

Add the health_data_access_body block to your config.json file:

"health_data_access_body": {
  "name": "Health Data Access Body Luxembourg",
  "contact_name": "HDAB Contact Point",
  "contact_email": "hdab@health.lu"
}

Field	Description
name	The official name of the Health Data Access Body. Displayed in the health metadata section of dataset records.
contact_name	The name of the contact point at the HDAB.
contact_email	The email address for health data access enquiries.