Linux

The Infrastructure Agent (Infra Agent) collects host-level metrics, logs, and traces from your Linux machines and securely ships them to your Middleware account. This guide covers installation on both Debian-based and RPM-based distributions using our install scripts.

Prerequisites

  1. System Requirements
    • CPU architectures: x86_64 and ARM
    • Memory: ≥ 1 GB (agent uses ~200 MB)
    • Tools: curl or wget installed on the host
  2. Supported Distributions
    • DEB-based: Ubuntu, Debian
    • RPM-based: Red Hat, CentOS, Fedora, SUSE, Rocky Linux, Oracle Linux, Amazon Linux
    • Other DEB/RPM distros may work but aren’t officially tested.
  3. AWS Instances
    • Use the RPM script on Red Hat or Amazon Linux instances.

Proxy users: If your host requires a proxy, set HTTP_PROXY and HTTPS_PROXY (and lowercase variants) before running the install script.

Installation

DEB-Based Distributions (Ubuntu, Debian)
RPM-Based Distributions (Red Hat, Amazon Linux, CentOS, Fedora, etc.)

1 Run the Installer:

1MW_API_KEY="<MW_API_KEY>" \
2MW_TARGET="https://<MW_UID>.middleware.io:443" \
3bash -c "$(curl -L https://install.middleware.io/scripts/deb-install.sh)"

2 (Optional) Add host tags:

1MW_HOST_TAGS="env:prod,role:web" \
2MW_API_KEY="<MW_API_KEY>" \
3MW_TARGET="https://<MW_UID>.middleware.io:443" \
4bash -c "$(curl -L https://install.middleware.io/scripts/deb-install.sh)"

3 Verify installation

1sudo systemctl status mw-agent
2sudo journalctl -u mw-agent -f    # stream live logs
Linux Agent

1 Run the Installer:

1MW_API_KEY="<MW_API_KEY>" \
2MW_TARGET="https://<MW_UID>.middleware.io:443" \
3bash -c "$(curl -L https://install.middleware.io/scripts/rpm-install.sh)"

2 (Optional) Add host tags:

1MW_HOST_TAGS="env:prod,role:web" \
2MW_API_KEY="<MW_API_KEY>" \
3MW_TARGET="https://<MW_UID>.middleware.io:443" \
4bash -c "$(curl -L https://install.middleware.io/scripts/rpm-install.sh)"

3 Verify installation

1sudo systemctl status mw-agent
2sudo journalctl -u mw-agent -f    # stream live logs

Service Management

Control the mw-agent service via systemd:

CommandDescription
sudo systemctl start mw-agentStart the agent
sudo systemctl stop mw-agentStop the agent
sudo systemctl restart mw-agentRestart the agent
sudo systemctl status mw-agentCheck agent status
sudo journalctl -u mw-agent -fStream live agent logs

Metrics Visibility

Once installed, host metrics will appear under Infrastructure → Hosts in the Middleware UI within a few minutes. If no data shows up:

  • Confirm network connectivity to https://<YOUR_UID>.middleware.io:443.
  • Ensure only one Infra Agent is running per host.
  • Check agent logs for errors in /var/log/mw-agent/mw-agent.log or via journalctl.

Troubleshooting

  • Multiple agents: Running more than one agent on the same host can cause data conflicts.
  • Proxy issues: Verify proxy environment variables if your host sits behind a corporate proxy.
  • Permission errors: Ensure you run install commands with sufficient privileges (use sudo where necessary).

Uninstall

DEB-Based
RPM-Based
1bash -c "$(curl -L https://install.middleware.io/scripts/deb-uninstall.sh)"
1bash -c "$(curl -L https://install.middleware.io/scripts/rpm-uninstall.sh)"

Need assistance or want to learn more about Middleware? Contact our support team at [email protected] or join our Slack channel.