Installation

This guide covers all methods to install the FixPanic CLI on your system.

Quick Install

The fastest way to get started is using the automated installation script:

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

The script automatically:

Detects your platform (Linux/macOS/Windows)
Downloads the latest version
Installs to the correct location
Adds fixpanic to your PATH

Note: The installation script is safe to run multiple times. It will update an existing installation to the latest version.

Manual Installation

If you prefer to install manually, download the binary for your platform and install it yourself.

Linux (amd64)

# Download the binary
curl -LO https://github.com/fixpanic/fixpanic-cli-tool/releases/latest/download/fixpanic-linux-amd64.tar.gz

# Extract
tar -xzf fixpanic-linux-amd64.tar.gz

# Install to system path
sudo mv fixpanic /usr/local/bin/

# Verify installation
fixpanic --version

Linux (arm64)

# Download the binary
curl -LO https://github.com/fixpanic/fixpanic-cli-tool/releases/latest/download/fixpanic-linux-arm64.tar.gz

# Extract
tar -xzf fixpanic-linux-arm64.tar.gz

# Install to system path
sudo mv fixpanic /usr/local/bin/

# Verify installation
fixpanic --version

macOS (Apple Silicon)

# Download the binary
curl -LO https://github.com/fixpanic/fixpanic-cli-tool/releases/latest/download/fixpanic-darwin-arm64.tar.gz

# Extract
tar -xzf fixpanic-darwin-arm64.tar.gz

# Install to system path
sudo mv fixpanic /usr/local/bin/

# Verify installation
fixpanic --version

Note: On macOS, you may need to allow the binary in System Preferences > Security & Privacy if you see a "developer cannot be verified" warning.

macOS (Intel)

# Download the binary
curl -LO https://github.com/fixpanic/fixpanic-cli-tool/releases/latest/download/fixpanic-darwin-amd64.tar.gz

# Extract
tar -xzf fixpanic-darwin-amd64.tar.gz

# Install to system path
sudo mv fixpanic /usr/local/bin/

# Verify installation
fixpanic --version

Windows

Download the latest release from the GitHub Releases page
Extract fixpanic-windows-amd64.exe from the archive
Rename to fixpanic.exe and move to a directory in your PATH
Open a new Command Prompt or PowerShell and verify:

fixpanic --version

Build from Source

If you need to build from source (for development or custom modifications):

Prerequisites

Go 1.21 or later

Build Steps

# Clone the repository
git clone https://github.com/fixpanic/fixpanic-cli-tool.git
cd fixpanic-cli-tool

# Build the binary
go build -o fixpanic

# Install to system path
sudo mv fixpanic /usr/local/bin/

# Verify
fixpanic --version

Requirements

Requirement	Details
Disk Space	Approximately 50MB (binary + logs)
Network	Outbound access to `socket.fixpanic.com:9000`
Permissions	Root access recommended for system-wide installation; user-level installation also supported

Installation Modes

The CLI supports two installation modes:

System Installation (Root)

When installed with root privileges (using sudo):

Component	Location
CLI Binary	`/usr/local/bin/fixpanic`
Agent Binary	`/usr/local/lib/fixpanic/`
Configuration	`/etc/fixpanic/agent.yaml`
Logs	`/var/log/fixpanic/agent.log`
Service	`/etc/systemd/system/fixpanic-connectivity-layer.service`

User Installation (Non-Root)

When installed without root privileges:

Component	Location
CLI Binary	`~/.local/bin/fixpanic`
Agent Binary	`~/.local/lib/fixpanic/`
Configuration	`~/.config/fixpanic/agent.yaml`
Logs	`~/.local/log/fixpanic/agent.log`

Warning: User-mode installation does not create a systemd service. You'll need to manage the agent process manually or set up your own service configuration.

Upgrading

To upgrade an existing installation to the latest version:

fixpanic upgrade

This command:

Checks for the latest available version
Downloads the new binary
Replaces the existing installation
Preserves your configuration

Uninstalling

To completely remove FixPanic:

# Stop and remove the agent first
fixpanic agent uninstall

# Then remove the CLI binary
sudo rm /usr/local/bin/fixpanic

Next Steps

Commands Reference - Learn all available CLI commands.
First Deployment - Deploy your first agent.

Installation

On this page