Skip to main content

Installing on Linux

This guide covers installing MetricsHub on Debian-based and Red Hat-based Linux distributions.

Supported versions: Debian 10+, Ubuntu 20.04+, RHEL/CentOS 8+

Automatic Install​

The fastest way to get started with MetricsHub Community is the one-line installer script, which works on any supported distribution:

curl -fsSL https://get.metricshub.com | bash

Once complete, verify the installation:

$HOME/metricshub/bin/metricshub --version

Manual Install​

If you prefer manual control over the installation, download the appropriate Debian package from metricshub.com/downloads.

x86_64:

sudo dpkg -i metricshub-community_3.9.02_amd64.deb

ARM64:

sudo dpkg -i metricshub-community_3.9.02_arm64.deb

Managing the Service​

MetricsHub runs as a systemd service. Use these commands to control it:

# Start the service
systemctl start metricshub-community-service

# Stop the service
systemctl stop metricshub-community-service

Uninstalling​

To remove MetricsHub Community from your system:

sudo dpkg -r metricshub-community

Upgrading​

To upgrade to a newer version:

  1. Download the latest package from metricshub.com/downloads
  2. Stop the service: systemctl stop metricshub-community-service
  3. Install the new package using dpkg -i (Debian/Ubuntu) or rpm -U (Red Hat/CentOS)

Your configuration files are preserved during the upgrade.

When complete, files are deployed to /opt/metricshub and the service starts automatically.

Next Steps​

Once installed, you're ready to configure MetricsHub:

  1. Configure your resources — define what to monitor
  2. Set up telemetry export — choose where to send metrics
  3. Access the Web UI — manage and monitor from your browser