First Deployment

This guide walks you through installing the FixPanic CLI and deploying your first autonomous agent.

Prerequisites

Before starting, ensure you have:

• A FixPanic account with a cluster created (Account Setup)
• Your Agent ID and API Key from the dashboard
• A server running Linux, macOS, or Windows
• Network access to socket.fixpanic.com:9000

Install the CLI

The fastest way to install the FixPanic CLI is using the automated installation script:

curl -fsSL https://install.fixpanic.com/install.sh | bash

The script automatically:

• Detects your operating system and architecture
• Downloads the latest CLI version
• Installs to the appropriate location
• Adds fixpanic to your PATH

Note: For manual installation options or building from source, see the CLI Installation Guide.

Verify Installation

Confirm the CLI is installed correctly:

fixpanic --version

You should see output like:

fixpanic version 1.0.0 (abc1234)

Deploy Your Agent

With the CLI installed, deploy an agent using your cluster credentials:

fixpanic agent install \
  --agent-id="your-agent-id" \
  --api-key="your-api-key"

Replace your-agent-id and your-api-key with the credentials you saved when creating your cluster.

What Happens During Installation

The installation process:

1. Registers the agent with the FixPanic platform
2. Downloads the connectivity layer binary
3. Creates configuration files in the appropriate locations
4. Starts the agent service (systemd on Linux, or background process)

Verify Your Agent

Check that your agent is running and connected:

fixpanic agent status

You should see output indicating the agent is Active and Connected:

Agent Status: Active
Connection:   Connected
Version:      1.0.0
Uptime:       2m 34s

View Agent Logs

Monitor your agent's activity in real-time:

fixpanic agent logs --follow

This shows:

• Connection events
• Task assignments
• Command executions
• Any errors or warnings

Press Ctrl+C to stop following logs.

Connect via Chat

Now that your agent is running, you can interact with it:

1. Open chat.fixpanic.com in your browser
2. Log in with your FixPanic account
3. Select your cluster from the dropdown
4. Start chatting! Try asking:
   • "What's the current CPU usage?"
   • "Show me the last 10 lines of /var/log/syslog"
   • "List running Docker containers"

Troubleshooting First Deployment

Agent won't start

Run the validation command to identify issues:

fixpanic agent validate

This checks for:

• Configuration file validity
• Permission issues
• Network connectivity
• Missing dependencies

Connectivity problems

Ensure your server can reach the FixPanic platform:

curl -I socket.fixpanic.com:9000

If this fails, check your firewall rules to allow outbound connections on port 9000.

Permission errors

If you installed as root, use sudo for management commands:

sudo fixpanic agent status

If you installed as a regular user, do not use sudo to avoid permission conflicts.

Next Steps

Congratulations! You've deployed your first FixPanic agent. Here's what to explore next:

• CLI Commands - Learn all available CLI commands for agent management.
• Chat Interface - Master the AI chat interface for interacting with agents.
• Core Concepts - Understand agents, clusters, and the FixPanic architecture.