DOCS

Documentation

Every way to install and run ClusterEye. One-line commands, full options.

Quick start

Pick the one that fits — all three are one-command installs.

FULL STACKEnd-to-end platform on a single host — ideal for dev & POC.

Kind + Helm

Installs Kind, Helm and the complete ClusterEye stack on Ubuntu 24.04.

bash
1curl -sSL https://archive.clustereye.com/clustereye-stack-install.sh | bash
STANDALONEProduction-ready — nginx + TLS + systemd.

Bare-metal Linux

Full platform directly on Linux — no Docker, no Kubernetes.

bash
1curl -fsSL https://archive.clustereye.com/deploy/standalone/install.sh | sudo bash -s -- \
2  --api-version=VERSION --ui-version=VERSION \
3  --domain=YOUR_DOMAIN_OR_IP --postgres=local
AGENTPlatforms: postgres · mongo · mssql

Agent only (Linux)

Just the agent, talking to an existing ClusterEye server.

bash
1curl -sSL https://archive.clustereye.com/install.sh | sudo bash -s -- -p postgres

Standalone install

ClusterEye API + UI on bare-metal Linux servers — no Docker, no Kubernetes. Comes with nginx reverse proxy.

Ubuntu 22.04+RHEL 8/9Oracle Linux 8/9
ClusterEye API
Go binary — REST API (:8080) + gRPC (:50051)
ClusterEye UI
Pre-built static frontend assets
nginx
Reverse proxy — TLS + plaintext h2c, HTTP/2, gRPC
PostgreSQL
Local or external database
InfluxDB
Optional time-series metrics
Single-command install (no Docker)
Auto-generated 10-year self-signed TLS certificate
nginx reverse proxy — HTTPS + plaintext h2c side-by-side
HTTP/2 and gRPC support (TLS and plaintext)
Optional local or external PostgreSQL
Optional local or external InfluxDB
Hardened systemd service
Independent API and UI versioning

Install options

All install.sh flags.

REQUIRED
--api-version=<ver>API binary version
--ui-version=<ver>UI assets version
--domain=<host|ip>Server domain or IP
POSTGRESQL
--postgres=local|externalMode (default: local)
--postgres-host=<host>External PG host
--postgres-port=<port>External PG port (default: 5432)
--postgres-user=<user>External PG user (default: postgres)
--postgres-password=<pwd>External PG password
--postgres-dbname=<n>DB name (default: clustereye)
--postgres-sslmode=<mode>SSL mode (default: disable)
INFLUXDB
--influxdb=local|external|noneMode (default: local)
--influxdb-url=<url>External InfluxDB URL
--influxdb-token=<token>External InfluxDB token
--influxdb-org=<org>Org (default: clustereye)
--influxdb-bucket=<bucket>Bucket (default: clustereye)
TLS
--tls=self-signed|providedMode (default: self-signed)
--cert=<path>Cert file (with --tls=provided)
--key=<path>Key file (with --tls=provided)
NETWORK
--port=<n>HTTPS port (default: 443)
--http-port=<n>|nonePlaintext h2c port (default: 80)
--bind-host=<host>Bind address (default: 0.0.0.0)
--extra-hostnames=a,b,cAdditional TLS SANs
OTHER
--no-firewallSkip firewall config
-h, --helpShow help
--versionShow installer version

Upgrade

In-place upgrade of API binary or UI assets. Config, secrets, TLS and databases are preserved.

bash
1curl -fsSL https://archive.clustereye.com/deploy/standalone/upgrade.sh | sudo bash -s -- \
2  --api-version=NEW --ui-version=NEW
--api-version=<ver>Upgrade API binary to this version
--ui-version=<ver>Upgrade UI assets to this version
-h, --helpShow help

Uninstall

Without flags: removes systemd service, binary, nginx config and journald drop-in. Configs, secrets, TLS and databases are preserved.

bash
1sudo ./uninstall.sh --purge --purge-db --purge-influxdb --yes-i-mean-it
(no flags)Remove only binary, systemd, nginx, journald
--purgeAlso remove /etc/clustereye, /var/lib/clustereye, /var/log/clustereye, web assets, user/group
--purge-dbAlso remove local PostgreSQL packages and data
--purge-influxdbAlso remove local InfluxDB packages and data
--yes-i-mean-itSkip confirmation prompt

ClusterEye Agent

Agent for monitoring PostgreSQL, MongoDB, and MS SQL Server.

Linux one-liner:
bash
1curl -sSL https://archive.clustereye.com/install.sh | sudo bash -s -- -p postgres
-pDatabase platform (postgres, mongo, mssql)
-kLicense key (optional)
-dInstall directory (default: /opt/clustereye)
-vSpecific version to install

Windows

For Windows x64:

clustereye-agent.exe
ClusterEye Agent for Windows
↓ Download
clustereyesetup.exe
Setup wizard for Windows
↓ Download
agent.yml.example
Example configuration file
↓ Download

Releases

Linux x86_64 agent binaries. Verify with SHA256.

VERSIONDATEARCHDOWNLOAD
v2.0.28LATESTJun 1, 2026x86_64
v2.0.26May 27, 2026x86_64
v2.0.25May 21, 2026x86_64
v2.0.23May 18, 2026x86_64

ARM64 support is available since v2616101459 (Sep 16, 2025). Windows x64 binaries are also downloadable.