Skip to main content

cPGuard CLI cpgcli Overview

The cPGuard CLI cpgcli provides a centralized command-line interface to manage and automate various cPGuard features directly from the server terminal.

It is designed for system administrators, DevOps engineers, hosting providers, and automation workflows that require direct access to cPGuard functionality without using the web interface.


Command Syntax

All interactions with the CLI follow a standardized structure:

cpgcli <command> --<option> [value]
  • command: The primary security module or subsystem you want to manage (e.g., scanner, fw, waf).
  • --option: The specific action or setting configuration.
  • value: Additional required arguments, paths, or variables.

Viewing Available Commands

To display all available commands:

cpgcli --help

To view help for a specific command:

cpgcli <command> --help

Example:

cpgcli scan --help

Permissions & Security

Many commands interact directly with:

  • Firewall rules
  • System services
  • Malware quarantine
  • Server-wide configurations

Because of this, cpgcli commands should be executed as:

root

Command Index

Use the command index below to quickly find details, instructions, and command options for any cpgcli module.

CommandDescription / PurposeReference Guide
licenseLicense activation, status checks, and metadata syncLicense, Setup & Config
configExport and import full configuration profilesLicense, Setup & Config
cloudConnection checking and syncing to cloud nodesLicense, Setup & Config
updateManage application and signature database updatesLicense, Setup & Config
support-accessGrant or revoke remote technical access keysLicense, Setup & Config
apiManage local API keys for automation portal hooksLicense, Setup & Config
standalone-confHardening profile wizards and setups for direct OS installationsLicense, Setup & Config
panel-integrationConfigure Single Sign-On and user features for control panelsLicense, Setup & Config
brandingWhite-label setups and branding assets configurationsLicense, Setup & Config
ui-usersAuthorize specific login accounts with UI permissionsLicense, Setup & Config
notificationSet up SMTP mail relays and customer alerts optionsLicense, Setup & Config
scannerStart, stop, or query background scanner stateMalware Scanner
dailyscanConfigure midnight incremental file scansMalware Scanner
weeklyscanConfigure Sunday midnight full file scansMalware Scanner
ai-scanToggle machine-learning heuristic enginesMalware Scanner
watchManage directories continuously monitored by the sensorMalware Scanner
whitelistExclude friendly system users and clean files from scansMalware Scanner
blacklistAdd specific script indicators to force-block during scansMalware Scanner
file-actionMap baseline active resolution metrics for found virusesMalware Scanner
cleanupControl automatic injection purging on scriptsMalware Scanner
log-actionDelete, quarantine, disable, or restore files from logsMalware Scanner
reportSubmit false positives or unchecked malware to labsMalware Scanner
scanRun manual scans, check active scan results, and manage scan jobsManual Scan and Operations
dbscanScan database tables for persistent malware injectionsDatabase Scanner
wafTurn on/off ModSecurity engines, manage rule whitelists, watch logsWeb Application Firewall & Upload Scanner
upload-scannerScan file uploads & block malicious script streamsWeb Application Firewall & Upload Scanner
fwManage system firewall state and engine wrappersFirewall & IP Management
ipAllow, deny, and clean specific IP boundariesFirewall & IP Management
lfdControl LFD services and intrusion jailsMonitors, LFD & Mail Queue
osmConfigure outbound SMTP rate limits and pattern blocksMonitors, LFD & Mail Queue
bot-checkEnable or disable bad bot and scraper filtrationProtection Modules
account-suspendSuspend compromised control panel accounts automaticallyProtection Modules
rootkitExecute rootkit scanning schedule parametersProtection Modules
srblEnable or disable SRBL DNSBL spam checksProtection Modules
cmsAuto WP update, WP cron overrides, and addon hardenersProtection Modules
process-monitorConfigure runtime tracking of host binariesMonitors, LFD & Mail Queue
cron-monitorMonitor cron tables for unauthorized injection entriesMonitors, LFD & Mail Queue
ip-reputationQuery block status of outbound server IPs in public feedsMonitors, LFD & Mail Queue