Running True Protection in Headless Mode
1,825 views
Updated Jun 5, 2026
96% found this helpful
Running True Protection in Headless Mode
True Protection by Jag can operate entirely from the command line without a graphical interface. Headless mode is ideal for servers, containers, CI/CD runners, and systems without a display.
Command-Line Interface
- tpj-cli status: Display current protection status, last scan time, and signature version.
- tpj-cli scan [path]: Run a scan on the specified path. Use --full for a full system scan or --quick for a quick scan.
- tpj-cli update: Check for and install signature and engine updates.
- tpj-cli quarantine list: View all quarantined items.
- tpj-cli quarantine restore [id]: Restore a quarantined item.
- tpj-cli config set [key] [value]: Modify configuration settings.
- tpj-cli logs: View recent protection logs.
Enabling Headless Mode
- Step 1: Install True Protection using the standard installer or package manager.
- Step 2: Run tpj-cli config set ui.mode headless to disable the graphical interface.
- Step 3: Configure the Management Console connection: tpj-cli config set server.url https://console.tpjsecurity.com.
- Step 4: Activate with your license: tpj-cli activate --key XXXX-XXXX.
Automation
Headless mode integrates with system schedulers (cron on Linux/macOS, Task Scheduler on Windows) for automated scanning. The CLI returns standard exit codes (0 for clean, 1 for threats found, 2 for errors) making it suitable for scripting and pipeline integration.
Was this article helpful?
Thank you for your feedback!