Running True Protection in Headless Mode

1,824 views Updated Jun 3, 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?