Docs/CLI Reference

CLI Reference

Complete reference for all TarPit.pro command-line commands.

Quick Reference

tarpit-pro start -f         # Start in foreground
tarpit-pro status           # Check status
tarpit-pro port list        # List ports
tarpit-pro attacks list     # View attacks (paid)
tarpit-pro config show      # View config

Core Commands

`start`

Start the honeypot service

Usage:tarpit-pro start [flags]

Flags:

-f, --foregroundRun in foreground with log output

-c, --config <path>Path to config file

Examples:

tarpit-pro start           # Start as daemon
tarpit-pro start -f        # Start in foreground
tarpit-pro start -c /etc/tarpit.yaml

`stop`

Stop the running honeypot

Usage:tarpit-pro stop

Examples:

tarpit-pro stop

`status`

Show current honeypot status

Usage:tarpit-pro status

Examples:

tarpit-pro status

`version`

Show version information

Usage:tarpit-pro version

Examples:

tarpit-pro version

Service Management

`install`

Install TarPit.pro as a system service

Usage:tarpit-pro install

Examples:

sudo tarpit-pro install

`uninstall`

Remove the system service

Usage:tarpit-pro uninstall

Examples:

sudo tarpit-pro uninstall

`service start`

Start via system service manager

Usage:tarpit-pro service start

Examples:

sudo tarpit-pro service start

`service stop`

Stop via system service manager

Usage:tarpit-pro service stop

Examples:

sudo tarpit-pro service stop

`service status`

Show service status

Usage:tarpit-pro service status

Examples:

tarpit-pro service status

`service restart`

Restart the service

Usage:tarpit-pro service restart

Examples:

sudo tarpit-pro service restart

Port Management

`port list`

List all configured honeypot ports

Usage:tarpit-pro port list

Examples:

tarpit-pro port list

`port add`

Add a port to monitor

Usage:tarpit-pro port add <port>

Examples:

tarpit-pro port add 8080
tarpit-pro port add 27017    # MongoDB
tarpit-pro port add 11211    # Memcached

`port remove`

Remove a port from monitoring

Usage:tarpit-pro port remove <port>

Examples:

tarpit-pro port remove 22    # Keep real SSH
tarpit-pro port remove 8080

`port add-defaults`

Add all default honeypot ports

Usage:tarpit-pro port add-defaults

Examples:

tarpit-pro port add-defaults

Attack Viewing (Paid Tiers)

`attacks list`

Show recent attacks

Usage:tarpit-pro attacks list [flags]

Flags:

-n, --limit <num>Number of attacks to show (default: 20)

--port <port>Filter by port

--ip <ip>Filter by IP address

Examples:

tarpit-pro attacks list
tarpit-pro attacks list -n 50
tarpit-pro attacks list --port 22

`attacks show`

Show details for a specific attack

Usage:tarpit-pro attacks show <id>

Examples:

tarpit-pro attacks show abc123

`attacks export`

Export attacks to file (Pro tier)

Usage:tarpit-pro attacks export [flags]

Flags:

-o, --output <file>Output file path

--format <fmt>Format: json, csv (default: json)

Examples:

tarpit-pro attacks export -o attacks.json
tarpit-pro attacks export --format csv -o attacks.csv

Configuration

`config show`

Display current configuration

Usage:tarpit-pro config show

Examples:

tarpit-pro config show

`config set`

Set a configuration value

Usage:tarpit-pro config set <key> <value>

Examples:

tarpit-pro config set tarpit.delay 5s
tarpit-pro config set logging.level debug
tarpit-pro config set storage.max_attacks 50000

`config reset`

Reset configuration to defaults

Usage:tarpit-pro config reset

Examples:

tarpit-pro config reset

License Management

`activate`

Activate a paid license

Usage:tarpit-pro activate <key>

Examples:

tarpit-pro activate YOUR-LICENSE-KEY

`deactivate`

Deactivate license (revert to free tier)

Usage:tarpit-pro deactivate

Examples:

tarpit-pro deactivate

`upgrade`

Show upgrade options and pricing

Usage:tarpit-pro upgrade

Examples:

tarpit-pro upgrade

Fleet Management (Paid Tiers)

`fleet list`

List all agents in your fleet

Usage:tarpit-pro fleet list

Examples:

tarpit-pro fleet list

`fleet bans`

Show fleet-wide bans

Usage:tarpit-pro fleet bans

Examples:

tarpit-pro fleet bans

`fleet sync`

Force sync with cloud

Usage:tarpit-pro fleet sync

Examples:

tarpit-pro fleet sync

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

Exit Codes

Code	Meaning
0	Success
1	General error
2	Invalid arguments
3	Permission denied
4	Service not running

Cloud Sync Fleet Management