Commands Reference

This page provides a complete reference for all FixPanic CLI commands.

Agent Commands

All agent management commands are grouped under fixpanic agent.

fixpanic agent install

Installs and configures a new agent on the current server.

fixpanic agent install --agent-id=<id> --api-key=<key>

Required Flags:

What it does:

1. Registers the agent with the FixPanic platform
2. Downloads the connectivity layer binary
3. Creates configuration files
4. Sets up and starts the systemd service (on Linux with root)

Example:

fixpanic agent install \
  --agent-id="clust_abc123def456" \
  --api-key="sk_live_xxxxxxxxxxxxx"

fixpanic agent status

Displays the current status of the agent service.

fixpanic agent status

Output includes:

• Running state (Active/Stopped)
• Connection status (Connected/Disconnected)
• Version information
• Uptime

Example output:

Agent Status: Active
Connection:   Connected
Version:      1.0.0
Uptime:       2h 34m 12s
PID:          12345

fixpanic agent start

Manually starts the agent process.

fixpanic agent start

Use this if the agent was stopped manually or failed to start automatically.

fixpanic agent stop

Manually stops the agent process.

fixpanic agent stop

Warning: Stopping the agent will disconnect it from the FixPanic platform. You won't be able to send commands to this server until the agent is restarted.

fixpanic agent restart

Restarts the agent process.

fixpanic agent restart

Equivalent to running stop followed by start. Useful after configuration changes.

fixpanic agent logs

Displays the agent's log output.

fixpanic agent logs [flags]

Flags:

Examples:

# Show last 100 lines
fixpanic agent logs

# Show last 50 lines
fixpanic agent logs --lines=50

# Stream logs in real-time
fixpanic agent logs --follow

# Short form
fixpanic agent logs -f -n 200

fixpanic agent validate

Validates the installation and configuration.

fixpanic agent validate

Checks for:

• Configuration file existence and validity
• Permission issues
• Network connectivity to the platform
• Agent binary presence
• Required directories

Example output:

✓ Configuration file found
✓ Configuration is valid
✓ Agent binary exists
✓ Network connectivity OK
✓ Permissions OK

Validation passed!

fixpanic agent uninstall

Removes the agent, configuration, and logs from the system.

fixpanic agent uninstall [flags]

Flags:

What it removes:

• Agent binary
• Configuration files
• Log files
• Systemd service (if installed)

Danger: This action is irreversible. Make sure you want to completely remove the agent before proceeding.

Example:

# With confirmation prompt
fixpanic agent uninstall

# Skip confirmation
fixpanic agent uninstall --force

CLI Commands

fixpanic upgrade

Updates the CLI tool to the latest available version.

fixpanic upgrade

What it does:

1. Checks GitHub for the latest release
2. Downloads the new binary for your platform
3. Replaces the current installation
4. Preserves all configuration

Example output:

Current version: 1.0.0
Latest version:  1.1.0

Downloading fixpanic v1.1.0...
Upgrade complete!

fixpanic --version

Displays the CLI version information.

fixpanic --version

Example output:

fixpanic version 1.0.0 (abc1234)
Built: 2024-01-15

fixpanic --help

Displays help information for any command.

# General help
fixpanic --help

# Help for a specific command
fixpanic agent --help
fixpanic agent install --help

Command Summary

Exit Codes

Next Steps

• Configuration - Learn about configuration files and parameters.
• Troubleshooting - Solutions to common issues.