Installation#

SenHub Agent is a monitoring collector that runs on your infrastructure and collects metrics from various sources (servers, applications, network devices). It installs as a system service and runs in the background.

System Requirements#

Resource requirements: 1 CPU core, 512 MB RAM, 500 MB disk space.

Network requirements (online mode only): The agent needs outbound HTTPS access to the SenHub platform for configuration synchronization and metrics delivery. In offline mode, no outbound connections are required.

Obtaining the Agent#

Contact SenHub support (support@senhub.io) to receive:

• The agent binary for your platform (senhub-agent or senhub-agent.exe)
• An authentication key (UUID format) for online mode
• A license token (required for premium probes: Citrix, NetScaler, Redfish, etc.)

Windows Installation#

1. Prepare the binary#

Copy senhub-agent.exe to the desired installation directory, for example C:\SenHub\.

2. Install the service#

Open a PowerShell terminal as Administrator and run:

cd C:\SenHub\
.\senhub-agent.exe install --authentication-key YOUR-UUID-KEY

This registers SenHub Agent as a Windows Service with automatic restart on failure.

For offline mode (local configuration only, no connection to SenHub platform):

.\senhub-agent.exe install --offline

To install with HTTPS enabled on the API:

.\senhub-agent.exe install --offline --enable-https --https-port 8443

3. Start the service#

.\senhub-agent.exe start

4. Verify the installation#

.\senhub-agent.exe status

You can also check the health endpoint:

Invoke-WebRequest -Uri "http://localhost:8080/health"

Expected response:

{"status":"ok","version":"0.1.80","uptime":"1m30s","probes_active":2,"metrics_cached":12}

Log file location#

Windows logs are stored at:

%ProgramData%\SenHub\logs\senhubagent.log

Typically: C:\ProgramData\SenHub\logs\senhubagent.log

Log rotation: 10 MB max per file, 5 backup files, 30-day retention, compressed.

Linux Installation#

1. Prepare the binary#

sudo mkdir -p /opt/senhub/bin
sudo cp senhub-agent /opt/senhub/bin/
sudo chmod +x /opt/senhub/bin/senhub-agent

2. Install the service#

sudo /opt/senhub/bin/senhub-agent install --authentication-key YOUR-UUID-KEY

This creates and registers a systemd service (senhub-agent.service) with automatic restart on failure (10-second delay between restarts).

For offline mode:

sudo /opt/senhub/bin/senhub-agent install --offline

To install with HTTPS enabled and a custom certificate hostname:

sudo /opt/senhub/bin/senhub-agent install --offline \
  --enable-https \
  --https-hosts "agent.company.com,192.168.1.100" \
  --https-port 8443

3. Start the service#

sudo /opt/senhub/bin/senhub-agent start

4. Verify the installation#

sudo /opt/senhub/bin/senhub-agent status

Or check the health endpoint:

curl http://localhost:8080/health

Log file location#

Linux logs are stored at:

/var/log/senhub/senhubagent.log

If this directory is not writable, logs fall back to the binary directory.

Log rotation: 10 MB max per file, 5 backup files, 30-day retention, compressed.

Installation Options#

The install command accepts the following options:

Authentication#

Configuration#

HTTPS / TLS#

Logging#

Environment Variables#

These environment variables can be used as alternatives to command-line flags:

What Happens During Installation#

When you run senhub-agent install, the agent:

1. Checks for administrator/root privileges (required on Windows and Linux)
2. Registers the system service (SenHub Agent on Windows, senhub-agent.service on Linux)
3. Configures automatic restart on failure
4. In offline mode: generates a default agent-config.yaml file with a unique agent key
5. If --enable-https is specified: creates a certs/ directory with a self-signed certificate and private key (valid for 365 days)

Files Created#

Service Management Commands#

The agent binary provides built-in service management:

Console Mode#

The run command starts the agent interactively in the foreground (not as a service). This is useful for debugging:

senhub-agent run --authentication-key KEY --verbose

All logs are printed to the console. Press Ctrl+C to stop.

Updating the Agent#

To update the agent to a new version:

senhub-agent update 0.1.85

You can preview the update without applying it:

senhub-agent update 0.1.85 --dry-run

Post-Installation Checklist#

After installing and starting the agent, verify the following:

1. The service is running: senhub-agent status
2. The health endpoint responds: curl http://localhost:8080/health
3. The web dashboard is accessible: open http://localhost:8080/web/{key}/ in a browser
4. Probes are collecting metrics: check the probes endpoint curl http://localhost:8080/api/{key}/info/probes
5. The log file exists and is being written to

Next Steps#

After installation:

1. Configure your monitoring probes (see Configuration)
2. Activate your license if you have premium probes (see License section in Configuration)
3. Set up HTTPS if required (see HTTP/HTTPS Configuration)
4. Configure your monitoring system (PRTG, Nagios, Grafana) to collect metrics (see Web Interface)

Uninstallation#

Windows:

.\senhub-agent.exe stop
.\senhub-agent.exe uninstall

Linux:

sudo /opt/senhub/bin/senhub-agent stop
sudo /opt/senhub/bin/senhub-agent uninstall

The uninstall command stops the service, removes the service registration, and cleans up generated files (configuration, certificates, logs).