CLI Reference
Complete command-line reference for TarPit.pro, organized by category.
Quick Reference
tarpit-pro start -f # Start in foreground with logs
tarpit-pro status # Check honeypot status
tarpit-pro port list # List active ports
tarpit-pro attacks list # View recent attacks (paid)
tarpit-pro config show # View current configuration
tarpit-pro bans list # View banned IPsCore Commands
| Command | Description |
|---|---|
| tarpit-pro start | Start the honeypot (daemon mode) |
| tarpit-pro start -f | Start in foreground with log output |
| tarpit-pro stop | Stop the running honeypot |
| tarpit-pro status | Show current honeypot status |
| tarpit-pro version | Show version, build date, and platform |
Service Management
| Command | Description |
|---|---|
| tarpit-pro install | Install as system service (systemd/launchd) |
| tarpit-pro uninstall | Remove the system service |
| tarpit-pro service start | Start via system service manager |
| tarpit-pro service stop | Stop via system service manager |
| tarpit-pro service status | Show service status |
| tarpit-pro service restart | Restart the service |
Port Management
| Command | Description |
|---|---|
| tarpit-pro port list | List all configured honeypot ports |
| tarpit-pro port add <port> | Add a port to monitor |
| tarpit-pro port remove <port> | Remove a port from monitoring |
| tarpit-pro port add-defaults | Add all default honeypot ports |
| tarpit-pro port scan | Scan for available ports |
| tarpit-pro port profile <name> | Apply a named port profile |
Configuration
| Command | Description |
|---|---|
| tarpit-pro config show | Display current configuration |
| tarpit-pro config set <key> <val> | Set a configuration value |
| tarpit-pro config reset | Reset all configuration to defaults |
License Management
| Command | Description |
|---|---|
| tarpit-pro activate <key> | Activate a paid license |
| tarpit-pro deactivate | Revert to free tier |
| tarpit-pro upgrade | Show upgrade options and pricing |
| tarpit-pro init --code <code> | Register agent with a registration code |
Ban Management
| Command | Description |
|---|---|
| tarpit-pro bans list | List currently banned IPs |
| tarpit-pro bans unban <ip> | Unban a specific IP address |
Attack Viewing
Starter
| Command | Description |
|---|---|
| tarpit-pro attacks list | Show recent attacks (default: 20) |
| tarpit-pro attacks list -n 50 | Show last 50 attacks |
| tarpit-pro attacks list --port 22 | Filter by port |
| tarpit-pro attacks list --ip <ip> | Filter by attacker IP |
| tarpit-pro attacks show <id> | Show details for a specific attack |
| tarpit-pro attacks export -o <file> | Export attacks (Pro tier) |
Fleet Commands
Pro
| Command | Description |
|---|---|
| tarpit-pro fleet list | List all agents in your fleet |
| tarpit-pro fleet list -v | List with detailed information |
| tarpit-pro fleet bans | Show fleet-wide bans |
| tarpit-pro fleet sync | Force sync bans and rules from cloud |
| tarpit-pro fleet info <id> | Show details for a specific agent |
| tarpit-pro fleet rules list | List fleet firewall rules |
Log Commands
| Command | Description |
|---|---|
| tarpit-pro logs | Show recent log entries |
| tarpit-pro logs -n 100 | Show last 100 log lines |
| tarpit-pro logs -f | Follow logs in real-time (tail -f) |
AI Commands
Pro
| Command | Description |
|---|---|
| tarpit-pro ai status | AI engine status and statistics |
| tarpit-pro ai recommend | Show AI ban recommendations |
| tarpit-pro ai ban <ip> | Apply an AI-recommended ban |
CVE Commands
Pro
| Command | Description |
|---|---|
| tarpit-pro cve list | List detected CVEs from attacks |
| tarpit-pro cve update | Update the CVE signature database |
| tarpit-pro cve status | Show database version and match stats |
Threat Commands
| Command | Description |
|---|---|
| tarpit-pro threats list | List known threats and their scores |
| tarpit-pro threats sync | Sync threat intelligence from cloud |
| tarpit-pro threats status | Show threat database status |
Global Flags
| Flag | Description |
|---|---|
| -h, --help | Show help for any command |
| -v, --verbose | Enable verbose output |
| --config <path> | Path to config file |
| --no-color | Disable colored output |
| --json | Output in JSON format |
Exit Codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | General error |
| 2 | Invalid arguments |
| 3 | Permission denied |
| 4 | Service not running |