# Agent Installation

The Watchio agent is a lightweight process that runs on your hosts and sends metrics to the Watchio platform.

Supported Platforms

  • Linux (Ubuntu, Debian, RHEL, CentOS, Amazon Linux)
  • macOS
  • Windows
  • Docker
  • Kubernetes

Linux Installation

One-Line Install

bash
curl -fsSL https://get.watchio.io | sudo bash -s -- --api-key YOUR_API_KEY

Package Manager (Debian/Ubuntu)

bash
wget -qO- https://repo.watchio.io/gpg.key | sudo apt-key add -
echo "deb https://repo.watchio.io/apt stable main" | sudo tee /etc/apt/sources.list.d/watchio.list
sudo apt update
sudo apt install watchio-agent

Package Manager (RHEL/CentOS)

bash
sudo rpm --import https://repo.watchio.io/gpg.key
sudo yum-config-manager --add-repo https://repo.watchio.io/rpm/watchio.repo
sudo yum install watchio-agent

Docker Installation

bash
docker run -d --name watchio-agent \
  -e WATCHIO_API_KEY=YOUR_API_KEY \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /proc:/host/proc:ro \
  watchio/agent:latest

Kubernetes Installation

bash
helm repo add watchio https://charts.watchio.io
helm install watchio-agent watchio/agent \
  --set apiKey=YOUR_API_KEY \
  --namespace watchio --create-namespace

Configuration

See the [Configuration Guide](/docs/agent/configuration) for detailed configuration options.