4.2.5 Set up application settings
Last updated
Last updated
The next step is to configure some functional application settings. Some of these settings can be changed later, others must be configured now during installation and cannot be changed in production.
You will be referring to the 5. config: Applications Settings Excel sheet that would have been prepared in .
Prepare your src/api/applcation/application-config.ts source file. This is a Typescript file that is loaded in the application via an API explained in section .
Using our file as an example, update the settings according to your needs.
You can call your instance of OpenCRVS anything you like, such as "Farajaland CR"
These are your registration time periods and fees for death.
These are your registration time periods and fees for marriage.
Marriage registration only exists in beta in OpenCRVS v1.7.0. All events are covered in v1.9.0
Fees due for collection and correction of certificates are calculated and displayed according to this value.
This is a regular expression to evaluate if a supplied phone number minus country code is valid.
If you configure your form to include a field to capture a user's National ID number, then this regular expression can evaluate if the string is valid.
You can set the background of the login page to be a color of choice. You can always use the UI to change this color later, or use a tiled or full screen image.
Other available properties are:
This cannot be amended later in the UI and must be configured here. In application performance analytics, you can set the administrative level that you wish to aggregate field agent performance. We recommend that you leave this as DISTRICT as it refers to the FHIR "district" location level as opposed to your internal country name for location level 2. If your country is very small and has only 1 location level, set this to STATE.
This cannot be amended later in the UI and must be configured here. In application performance analytics, you can set the administrative level that you wish to aggregate field agent declaration completeness performance. We recommend that you leave this as DISTRICT as it refers to the FHIR "district" location level as opposed to your internal country name for location level 2. If your country is very small and has only 1 location level, set this to STATE.
This cannot be amended later in the UI and must be configured here. If you are using SMS or WhatsApp to send notifications to staff, set this to "sms". If you are using email, set this to "email"
This cannot be amended later in the UI and must be configured here. If you are using SMS or WhatsApp to send notifications to informants, set this to "sms". If you are using email, set this to "email"
This cannot be amended later in the UI and must be configured here. You will notice this separate property used by an API handler called by our analytics services. Whereas countries generally have crude birth rate ratios per area in their stastics, they tend to have a country-wide crude death rate. You can set this here in order to correctly calculate death registration completeness rates.
The National System Administrator can create new employees. In the create user forms, the requirement to add a transparent PNG signature for certain employee roles, so that the signature can appear on the certificate can be configured here.
The following features can be enabled on and off in this block. We refer to this block as "Feature flags
This cannot be amended later in the UI and must be configured here. In some countries, individuals do not know their date of birth. If you wish to enable that individuals are allowed to submit their ages in your declaration forms rather than a date of birth, set this to true. Please note that those individuals will have their days and months of birth automatically set to the 1st January in the system in that case.
Whether to enable the registration of death events in your OpenCRVS installation.
If enabled, you are able to print the review page of any declaration form including all the data entered by the applicant in an easy to read fashion. This can be a useful tool.
These props enable the informant signature component on the review page. Signatures are now configurable also in the form config so it is likely that this prop will be deprecated in future versions.
This prop controls the visibility of a workqueue that you can use for asynchronous integration with an external system at the point of registration via APIs. As an example, we use this for MOSIP asynchronous generation of a National ID.
The OpenCRVS Core Login application loads the following config js files before connecting to the OpenCRVS backend to serve all the content. The Login app has not communicated with the backend yet and needs to know how to access it
As you can see, the React Login application uses the URL values to understand how to connect to backend services such as the login authentication API and the country configuration API. Do not edit the URLs.
You must set some values:
For example, if you wanted to support Spanish and English, with Spanish being the default this string should be:
As you can see, the server config file contains the same settings.
You must set the COUNTRY & LANGUAGES values only.
Following the same process as you did for the production Login app config file, you must set the COUNTRY & LANGUAGES values.
These are your registration time periods in days and fees for birth, explained in more detail . PRINT_IN_ADVANCE allows you to print certificates in advance for collection. You can disable this by setting it to false, if you operationally want to enforce an ID check from a recipient before printing a copy.
The FEE object sets default fees for certification as a fallback if you havent configured individual fees for specific certificate templates. Explained in section
You can always use our Farajaland logo by default and then upload this in the UI later, but if you look at the top of the file, you can see that this refers to a property that imports a copy of your country logo as a base64 image. Do not change this property but instead, locate your official logo/crest, convert it to base64 and you can replace our logo [here]().
This cannot be amended later in the UI and must be configured here. This field should be left as false. It is a custom property allowing a country to pause the registration process at the point of registration for 3rd party asynchronous validation. If you wish to use this property please get in touch with us at. It is a legacy property that will likely be deprecated in OpenCRVS v1.4 due to relative underuse.
Whether to enable the registration of marriage events in your OpenCRVS installation. In OpenCRVS v1.3 we have released marriage registration in BETA. Set this property to true in order to demonstrate marriage registration as a proof of concept. Get in touch with us at if you wish to use marriage registration in production. We require to complete marriage performance analytics and searching in order to release this feature in a future version. It is not yet production ready.
Login app - localhost development:
COUNTRY: Set the to be the same as the value you used when importing the set up files in step 3.2.5. The Login app needs to convert users phone numbers into MSISDN numbers using an Alpha 3 country code in case the user forgets their login details and requires an SMS reset.
LANGUAGES: This property allows you to customise the global language options. This value is a comma separated string of language codes for every translation you wish to set up in step .
Login app - server:
You may notice that localhost is replaced by your domain name dynamically in handlebars. Do not edit the URLs. We have taken care of this substitution for you in step
Client app - localhost development:
Following the same process as you did for the local development Login app config file, you must set the COUNTRY & LANGUAGES values, and can optionally uncomment LEADERBOARDS_DASHBOARD_URL, REGISTRATIONS_DASHBOARD_URL and STATISTICS_DASHBOARD_URL if you wish to run metabase dashboards locally. Refer to for more instructions.
Client app - server: