Pre-compiled binaries and installation scripts for ClusterEye

Quick Install

$ Full Stack (Kind + Helm)
curl -sSL https://archive.clustereye.com/clustereye-stack-install.sh | bash

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

$ Standalone (Bare-Metal)
curl -fsSL https://archive.clustereye.com/deploy/standalone/install.sh | sudo bash -s -- --api-version=VERSION --ui-version=VERSION --domain=YOUR_DOMAIN_OR_IP --postgres=local

Full platform on bare-metal Linux — no Docker required

$ Agent Only (Linux)
curl -sSL https://archive.clustereye.com/install.sh | sudo bash -s -- -p postgres

Platforms: postgres, mongo, mssql

Standalone Installation

Standalone installation for bare-metal Linux servers. Installs ClusterEye API + UI with nginx reverse proxy, without Docker or Kubernetes.

Ubuntu 22.04+ RHEL 8/9 Oracle Linux 8/9

Quick Install

curl -fsSL https://archive.clustereye.com/deploy/standalone/install.sh | sudo bash -s -- --api-version=VERSION --ui-version=VERSION --domain=YOUR_DOMAIN_OR_IP --postgres=local

Replace VERSION with the desired version numbers. Defaults serve HTTPS on 443 and plaintext HTTP/h2c on 80 (for plaintext gRPC agents). API and UI versions can differ.

Components

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

Features

  • Single-command installation (no Docker required)
  • 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
  • systemd service with security hardening
  • Independent API and UI versioning

Install Options (install.sh)

Required
  • --api-version=<ver> — API binary version
  • --ui-version=<ver> — UI assets version
  • --domain=<host|ip> — Server domain or IP address
PostgreSQL
  • --postgres=local|external — Mode (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=<name> — Database name (default: clustereye)
  • --postgres-sslmode=<mode> — SSL mode (default: disable)
InfluxDB
  • --influxdb=local|external|none — Mode (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|provided — Mode (default: self-signed)
  • --cert=<path> — Certificate file (with --tls=provided)
  • --key=<path> — Key file (with --tls=provided)
Network
  • --port=<n> — HTTPS port (default: 443)
  • --http-port=<n>|none — Plaintext HTTP/h2c port for plaintext gRPC agents; 'none' disables (default: 80)
  • --bind-host=<host> — Bind address (default: 0.0.0.0)
  • --extra-hostnames=a,b,c — Additional TLS SANs
Other
  • --no-firewall — Skip firewall configuration
  • -h, --help — Show help
  • --version — Show installer version

Upgrade (upgrade.sh)

In-place upgrade of the API binary or UI assets. Config, secrets, TLS, and databases are preserved. Detects existing ports automatically from the live nginx config.

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

At least one of --api-version or --ui-version is required. Specify both to upgrade together.

Uninstall (uninstall.sh)

Without flags, removes the systemd service, binary, nginx config, and journald drop-in. Configs, secrets, TLS, and databases are preserved. Use the purge flags to remove everything.

sudo ./uninstall.sh --purge --purge-db --purge-influxdb --yes-i-mean-it
Options
  • (no flags) — Remove binary, systemd unit, nginx config, journald drop-in only
  • --purge — Also remove /etc/clustereye, /var/lib/clustereye, /var/log/clustereye, web assets, user/group
  • --purge-db — Also remove local PostgreSQL packages and data (drops the clustereye DB and role first)
  • --purge-influxdb — Also remove local InfluxDB packages, data, CLI configs, repo and GPG keys
  • --yes-i-mean-it — Skip confirmation prompt
install.sh Installer
Download
upgrade.sh Upgrader
Download
uninstall.sh Uninstaller
Download

Linux Releases

v2.1.25 Latest
October 31, 2026
clustereye-agent-linux-amd64 x86_64
v2.1.24
October 30, 2026
clustereye-agent-linux-amd64 x86_64
config.yaml Example Config
v2.1.23
October 28, 2026
clustereye-agent-linux-amd64 x86_64
config.yaml Example Config

Windows

Windows Windows x64
clustereye-agent.exe ClusterEye Agent for Windows

ClusterEye OS

The ClusterEye server as a ready system image: PostgreSQL, ClickHouse and InfluxDB built in (each can be external), set up from its console, the OVA wizard or cloud-init, upgraded in place with automatic rollback.

gpg --import eye-release-signing.asc && gpg --verify SHA256SUMS.asc SHA256SUMS && sha256sum -c --ignore-missing SHA256SUMS

Release key fingerprint: 447C FB9B D464 F747 8661 1715 7E12 CCDF EDF9 400F

ClusterEye OS v0.1.1 (latest)

October 5, 2026 · clustereye-api v1.6.17 · clustereye-ui v1.6.21

eye-os-0.1.1.iso Bare metal and any hypervisor (BIOS + UEFI)
Download
eye-os-0.1.1.ova VMware vSphere / Workstation
Download
eye-os_0.1.1.qcow2 KVM, Proxmox, OpenStack (qcow2)
Download
eye-os_0.1.1.update.tar In-place upgrade of an existing server
Download
SHA256SUMS SHA256SUMS
Download
SHA256SUMS.asc Signature of SHA256SUMS
Download

ClusterEye OS v0.1.0

October 4, 2026 · clustereye-api v1.6.15 · clustereye-ui v1.6.17

eye-os-0.1.0.iso Bare metal and any hypervisor (BIOS + UEFI)
Download
eye-os-0.1.0.ova VMware vSphere / Workstation
Download
eye-os_0.1.0.qcow2 KVM, Proxmox, OpenStack (qcow2)
Download
eye-os_0.1.0.update.tar In-place upgrade of an existing server
Download
SHA256SUMS SHA256SUMS
Download
SHA256SUMS.asc Signature of SHA256SUMS
Download

ClusterEye Stack Install

Complete stack installation for Ubuntu 24.04. Installs Kind, Helm, and deploys the full ClusterEye platform with PostgreSQL, InfluxDB, and all services.

curl -sSL https://archive.clustereye.com/clustereye-stack-install.sh | bash

Features:

  • Interactive configuration prompts
  • Automatic Kind cluster creation (1 control-plane + 2 workers)
  • Helm-based deployment
  • SSL/HTTPS support
  • Auto-generated secure credentials
Download clustereye-stack-install.sh

Agent Install Script

Automated installation script for ClusterEye Agent. Supports PostgreSQL, MongoDB, and MS SQL Server monitoring with systemd service setup.

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

Options:

  • -p - Database platform (postgres, mongo, mssql)
  • -k - License key (optional)
  • -d - Install directory (default: /opt/clustereye)
  • -v - Specific version to install
Download install.sh