Configuration Overview & sentinel-agent.toml

Edit Article

A plain-language guide to every setting inside the Sentinel agent configuration file.

Sentinel Operations Team
5 min read
Updated August 28, 2026
v3.2

The Sentinel agent configuration is stored in a clean, human-readable file named **sentinel-agent.toml** located at `C:\Program Files\Sentinel\config\sentinel-agent.toml` on Windows (or `/etc/sentinel/sentinel-agent.toml` on Linux).

sentinel-agent.toml
1[server]
2# The HTTPS address of your central Sentinel management server
3base_url = "https://endpoint.yourcompany.com"
4connect_timeout_secs = 10
5request_timeout_secs = 30
6 
7[agent]
8# How often the agent pings the server (in seconds)
9heartbeat_interval_secs = 60
10# How often the agent checks for updated security policies (in seconds)
11policy_sync_interval_secs = 300
12# Local working directory for encrypted database and logs
13data_dir = "C:\\ProgramData\\Sentinel"
14 
15[queue]
16# Offline SQLite database path
17db_path = "C:\\ProgramData\\Sentinel\\events.db"
18# Maximum events uploaded in a single batch
19batch_size = 100
20# Upload frequency for telemetry logs (in seconds)
21upload_interval_secs = 30
22 
23[monitors]
24# How often to check active foreground applications (in seconds)
25activity_poll_interval_secs = 5
26# How often to audit browser history (in seconds)
27website_poll_interval_secs = 30
28 
29[logging]
30# Log detail level: "error", "warn", "info", "debug"
31level = "info"
32directory = "C:\\ProgramData\\Sentinel\\logs"
SectionParameterDefault ValueWhat It Does
[server]base_urlRequired URLThe central Sentinel server address where all data is securely sent.
[agent]heartbeat_interval_secs60 secondsInterval between "I am alive" pings. Lower values show faster online/offline status in console.
[monitors]activity_poll_interval_secs5 secondsFrequency of foreground application tracking. 5s gives high precision with negligible CPU.
[monitors]website_poll_interval_secs30 secondsFrequency of browser URL checking for Chrome, Edge, and Firefox.
Tags:#Configuration#TOML#Settings Guide

Was this documentation page helpful?

Your technician feedback helps our team continuously improve Sentinel guides.