OpsVera Agent Installation & Quickstart Guide
Deploy the ultra-lightweight ops-agent binary to any Linux server in under 60 seconds.
One-Liner Automated Installation
Run the following command on your target Linux machine as root or with sudo. The installer will automatically detect your OS distribution, architecture (x86_64 / aarch64), download the signed binary, configure systemd, and establish an outbound mTLS handshake.
curl -fsSL https://agent.opsvera.dev/install.sh | sudo bash -s -- --token=YOUR_WORKSPACE_TOKEN
Verify Agent Health & mTLS Handshake
Once installed, verify the service status with systemctl and run the diagnostic check:
systemctl status opsvera-agent opsvera-agent --test-connection System Requirements & Firewall Policy
- Ubuntu 20.04, 22.04, 24.04 LTS
- Debian 11 (Bullseye), 12 (Bookworm)
- RHEL / AlmaLinux / Rocky Linux 8 & 9
- Alpine Linux 3.16+
- RAM: < 15 MB resident memory
- CPU: < 0.1% baseline overhead
- Binary size: ~8.5 MB static Go ELF
- Zero external shared libraries
- Inbound: 0 ports needed (None)
- Outbound: TCP Port 443 (HTTPS)
- Encrypted with TLS 1.3 + Client Cert
- Safe through restrictive NAT/VPC
Backup Watchdog & Custom Health Hooks
OpsVera automatically detects active Borg and Restic repositories. To integrate custom cron backup scripts or trigger instant health pulses:
# Example: Sending a backup completion heartbeat from your cron script
/usr/local/bin/opsvera-agent backup-notify \
--repo="borg://backup.corp.internal/var/backups" \
--status=success \
--bytes=42949672960 \
--duration=312s
Engineered for Massive Scale &
Zero-Trust Telemetry
A decoupled, highly reliable architecture designed to handle tens of thousands of simultaneous agent telemetry streams without lagging or dropping events.
Outbound-Only Go Agent (ops-agent)
Installed on edge Linux nodes via a single curl command. Operates strictly outbound, establishing mutual TLS with agent.opsvera.dev. Periodically streams encrypted heartbeats, CPU/RAM/Disk metrics, Docker status, and CrowdSec security events.
High-Throughput Ingestion & Queues
Incoming telemetry packets are authenticated in microseconds and pushed to Redis queues. Horizon workers ingest metrics asynchronously, ensuring sub-second response times and zero bottlenecks during fleet-wide traffic spikes.
TimescaleDB Hypertable & Multi-Tenant RLS
Time-series metrics are partitioned automatically into hypertable chunks for lightning-fast aggregation queries. Row-Level Security (RLS) is strictly enforced on all tables, providing mathematical isolation between tenants.
Vue 3 SPA & Real-Time Reverb WebSockets
The frontend control panel runs as a fast single-page app (SPA) at app.opsvera.dev. Live metric gauges, topology graph nodes, and alert toasts update seamlessly in real time without refreshing.
Service Domain Topology
Supercharge Your Infrastructure Operations Today
Join forward-thinking MSPs, cloud agencies, and DevOps teams who manage thousands of mission-critical Linux nodes effortlessly with OpsVera.