---
title: cavpoller
description: cavpoller standalone status poller
weight: 1020
---

The `cavpoller` command is a standalone tool  to poll various applications status (up/down). It is a sidecar component to the main Cavalina app_status application.  It should be deployed in several key location in your network. See the APP-STATUS application documentation for usage.


## Setup overview

1. Select the appropriate binary version from the cavaliba/cavpoller/bin/ folder
2. Create an API Key in your Cavaliba instance with appropriate permissions
3. Optionnally, create a ~/.cavaliba/cavpoller.yaml configuration file
4. run cavpoller
5. install as periodic run (systemctl, crontab, docker container)


## crontab setup

```
crontab -e
* * * * * /path/to/my/cavpoller cron > /var/log/cavpoller.log 2>&1
```


## systemctl setup

TBD


## Build

You can build your own cavpoller binary. Setup GOLANG on your system and download the latest cavaliba dsitribution.

Use the `make build` from the cavaliba/cavpoller/ source directory. The resulting binary is in the build/ subfolder. 

You can copy/install this binary on other machines with the same OS/ARCH. See GOLANG cross compilation for details.



## Revisions

2025/08/22 - v0.0.0 - init from cavmonitor, version

