Skip to main content

Enable the Audit System in dhis.conf

To allow DHIS2 Audit Vision to read audit logs, you must enable the DHIS2 audit system in your server configuration.

Step 1 – Locate dhis.conf

Your DHIS2 configuration file is typically located at:

  • /etc/dhis/dhis.conf
  • Or in your DHIS2 home directory

Step 2 – Configure Audit Properties

Open the file and add or modify the audit property. For example, to audit Metadata and Tracker data:

dhis.conf
audit = METADATA, TRACKER

Supported Audit Scopes

ValueDescription
METADATAChanges to metadata objects (data elements, indicators, etc.)
TRACKERChanges to tracked entity instances and enrollments
READRead operations
CREATECreation of new objects
UPDATEUpdates to existing objects
DELETEDeletion of objects
SEARCHSearch operations
DISABLEDTurns the audit log system off
tip

If you want all standard operations audited, you can often omit this line entirely — DHIS2 enables auditing for standard scopes by default.

Step 3 – Save and Restart DHIS2

After editing dhis.conf, restart your DHIS2 instance (Tomcat) to apply the changes:

sudo systemctl restart tomcat

Next Steps