> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catops.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get server monitoring running in under 2 minutes

## Choose Your Path

<Tabs>
  <Tab title="Cloud (Recommended)">
    Best for: Quick setup, no infrastructure management, free tier

    <Steps>
      <Step title="Create Account">
        Go to [catops.app](https://catops.app) and sign up with email or GitHub.
      </Step>

      <Step title="Install Agent">
        Run this on your server:

        ```bash theme={null}
        curl -fsSL https://get.catops.app/install.sh | bash
        ```

        <Info>
          Don't use `sudo` - the CLI installs to your home directory.
        </Info>
      </Step>

      <Step title="Connect to Cloud">
        Copy your auth token from the dashboard and run:

        ```bash theme={null}
        catops auth login YOUR_TOKEN
        ```
      </Step>

      <Step title="Start Monitoring">
        ```bash theme={null}
        catops service install
        catops service start
        ```

        That's it! Your server now appears in the Cloud dashboard.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Hub (Self-Hosted)">
    Best for: Privacy-focused, air-gapped networks, data sovereignty

    <Steps>
      <Step title="Install Hub">
        Run on your server (requires root):

        ```bash theme={null}
        curl -fsSL https://get.catops.app/hub.sh | sudo sh
        ```
      </Step>

      <Step title="Open Dashboard">
        Navigate to:

        ```
        http://your-server-ip:8090
        ```
      </Step>

      <Step title="Create Admin Account">
        Set up your admin username and password on first visit.
      </Step>

      <Step title="Activate License">
        Go to Settings → Activate and enter your license key.

        <Card title="Get a License" icon="key" href="https://catops.app/hub-licenses">
          Purchase at catops.app/hub-licenses
        </Card>
      </Step>
    </Steps>
  </Tab>

  <Tab title="CLI Only">
    Best for: Local monitoring, quick server checks, no dashboard needed

    <Steps>
      <Step title="Install CLI">
        ```bash theme={null}
        curl -fsSL https://get.catops.app/install.sh | bash
        ```
      </Step>

      <Step title="Check Status">
        ```bash theme={null}
        catops status
        ```

        You'll see CPU, memory, disk, and network metrics.
      </Step>

      <Step title="View Processes">
        ```bash theme={null}
        catops processes
        ```

        Shows top processes by CPU and memory usage.
      </Step>

      <Step title="Ask AI (Optional)">
        ```bash theme={null}
        catops ask "why is my disk full?"
        ```

        Requires Cloud mode for AI features.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## What's Next?

<CardGroup cols={2}>
  <Card title="Add Health Checks" icon="heart-pulse" href="/cloud/health-checks">
    Monitor your websites and APIs
  </Card>

  <Card title="Set Up Alerts" icon="bell" href="/cloud/alerts">
    Get notified via Telegram, email, or Slack
  </Card>

  <Card title="Add More Servers" icon="server" href="/cloud/servers">
    Install the agent on additional servers
  </Card>

  <Card title="Docker Monitoring" icon="docker" href="/hub/containers">
    Monitor your containers and logs
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Agent not connecting to Cloud">
    1. Check your auth token: `catops auth info`
    2. Restart the service: `catops restart`
    3. Check logs: `catops service status`
  </Accordion>

  <Accordion title="Hub dashboard not loading">
    1. Check if service is running: `systemctl status catops-hub`
    2. Check firewall: `sudo ufw allow 8090`
    3. View logs: `journalctl -u catops-hub -f`
  </Accordion>

  <Accordion title="Permission denied during install">
    * For CLI: Don't use `sudo`, it installs to `~/.local/bin`
    * For Hub: You need `sudo` as it installs to `/opt/catops`
  </Accordion>
</AccordionGroup>