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

# Servers

> Manage your entire server fleet — connect agents, monitor health, provision cloud servers, and apply configuration templates.

<Warning>
  Multi-server management via the binary agent is **exclusively available on the Hosted plan**. On the self-hosted version, AreaWP manages the single server it is installed on — the Agent Fleet, Fleet Monitor, Cloud Servers, and Server Templates features are not available.
</Warning>

<Info>
  **Path:** Servers (`/servers`) — Admin only

  The Servers section is the hub for multi-server management. It contains four sub-sections: Agent Fleet, Fleet Monitor, Cloud Servers, and Server Templates.
</Info>

<CardGroup cols={2}>
  <Card title="Agent Fleet" icon="users" color="#6366f1">
    Register and manage all connected servers
  </Card>

  <Card title="Fleet Monitor" icon="chart-line" color="#10b981">
    Real-time metrics heatmap and alerts across all servers
  </Card>

  <Card title="Cloud Servers" icon="cloud" color="#f59e0b">
    Provision new VPS instances on cloud providers
  </Card>

  <Card title="Server Templates" icon="file-code" color="#8b5cf6">
    Define and enforce server configurations fleet-wide
  </Card>
</CardGroup>

***

## Agent Fleet

**Path:** `/fleet`

### Fleet Health Summary

Four stat cards at a glance:

| Card             | Shows                                    |
| ---------------- | ---------------------------------------- |
| **Total Agents** | All registered servers                   |
| **Online**       | Currently connected agents               |
| **Offline**      | Unreachable agents                       |
| **Success Rate** | Percentage of agents responding normally |

Below the cards: uptime %, heartbeat latency, and queued command count. A **Version Distribution** card shows what percentage of your fleet is on each agent version.

### Fleet Tabs

<AccordionGroup>
  <Accordion title="Dashboard" icon="gauge">
    Health overview with uptime graphs, latency metrics, and version distribution across the fleet.
  </Accordion>

  <Accordion title="Versions" icon="tag">
    All agent versions in the fleet — version number, release channel, published date, compatibility status, edit/delete actions.
  </Accordion>

  <Accordion title="Rollouts" icon="arrows-rotate">
    Trigger fleet-wide agent upgrades. Choose a strategy:

    * **All at once** — upgrade all agents simultaneously
    * **Staged** — upgrade in batches with configurable delay
    * **Canary** — upgrade a small percentage first, then roll out

    Monitor rollout progress (processed / total / failed) and cancel any in-progress rollout.
  </Accordion>

  <Accordion title="Command Queue" icon="list">
    Commands queued for offline agents. Retry any queued command manually.
  </Accordion>

  <Accordion title="Discovery" icon="magnifying-glass">
    Scan the local network for new agents. Discovered servers appear as cards with hostname, IP, OS, and version. Add to the fleet with one click.
  </Accordion>

  <Accordion title="Approvals" icon="check">
    Approve or reject pending agent registration requests.
  </Accordion>
</AccordionGroup>

### Connecting a New Server

<Steps>
  <Step title="Run the install command on the target server">
    ```bash theme={null}
    curl -fsSL https://your-panel.com/install.sh | sudo bash -s -- \
      --token "sk_reg_YOUR_TOKEN" \
      --server "https://your-panel.com"
    ```
  </Step>

  <Step title="Agent auto-registers">
    The agent installs as a systemd service, connects via WebSocket, and appears in the **Approvals** tab (or the fleet list directly if auto-approve is on).
  </Step>

  <Step title="View agent diagnostics">
    Click any agent to open the diagnostics modal — connection status, latency, command stats, recent sessions.
  </Step>
</Steps>

***

## Fleet Monitor

**Path:** `/fleet-monitor`

Real-time monitoring across all connected servers simultaneously.

| Tab                      | Content                                                                     |
| ------------------------ | --------------------------------------------------------------------------- |
| **Overview**             | Color-coded heatmap — CPU, memory, disk, container count, status per server |
| **Comparison**           | Select servers + metric + period → area chart with CSV export               |
| **Alerts**               | Active/acknowledged/resolved alerts + threshold configuration               |
| **Anomalies & Forecast** | Z-score anomaly detection; capacity forecasting to 90%/100%                 |
| **Fleet Search**         | Search across servers, containers, and tags                                 |

### Heatmap Color Scale

| Color     | Usage   |
| --------- | ------- |
| 🟢 Green  | 0–50%   |
| 🟡 Yellow | 50–75%  |
| 🟠 Orange | 75–90%  |
| 🔴 Red    | 90–100% |

***

## Cloud Servers

**Path:** `/cloud`

Provision cloud VPS instances directly from AreaWP (requires provider API key in Settings):

* DigitalOcean, Hetzner, Vultr, Linode

After provisioning, the agent is automatically installed on the new server.

***

## Server Templates

**Path:** `/server-templates`

Define configuration templates and enforce them fleet-wide.

### Compliance Bar

Shows at the top of the Templates page:

* ✅ **Compliant** — servers matching the template
* ⚠️ **Drifted** — servers that have diverged from the template
* ❓ **Unknown** — servers not yet checked

Enable **auto-remediate** on a template to re-apply it automatically when drift is detected.

### Template Library

Pre-built templates (LEMP stack, WordPress server, Docker host, etc.) in the **Library** tab. Click **Use** to create a customizable copy.