Self-host Blackbox Exporter on a VPS
A Prometheus exporter that probes endpoints over HTTP, HTTPS, DNS, TCP and ICMP and reports the results as metrics. It ships with the standard probe modules.
levelrail-cli templates deploy blackbox-exporter --name my-blackbox-exporterSpecification
- Status
- Listed
- Category
- Monitoring
- Services
- blackbox
- Ports
- 9115
- Volumes
- 0
- Memory
- about 64 MiB
- arm64
- unknown
- amd64
- unknown
- Settings to fill in
- none
- License
- Permissive license, Apache-2.0
- Listing
- Community template
About Blackbox Exporter
A Prometheus exporter that probes endpoints over HTTP, HTTPS, DNS, TCP and ICMP and reports the results as metrics. It ships with the standard probe modules.
What it deploys
Blackbox Exporter runs as one service in a single Compose app, listening on port 9115.
| Service | Image | Tag | Ports | Volumes |
|---|---|---|---|---|
| blackbox | prom/blackbox-exporter | v0.29.1 | 9115 | none |
Before you install
- CPU architecture. arm64 unknown. The scan could not read a manifest or the tag is chosen at install time. This is not a claim either way.
- Listed. It is in the catalog. Back up the data volume before changing an image tag.
Settings and environment
The catalog lists no environment variables for this template.
First run
- Probe a target with /probe?target=https://example.org&module=http_2xx and scrape it from Prometheus.
Install Blackbox Exporter on a VPS
-
Install Levelrail on a fresh VPS
Run this as root on a Linux server (amd64 or arm64) with ports 80 and 443 reachable. The installer prints a setup link.
curl -fsSL https://levelrail.com/install.sh | sudo sh -
Sign in
Open the setup link, choose a password, then log the CLI in. The CLI install command is
curl -fsSL https://levelrail.com/install-cli.sh | shif the machine does not have it. See Getting started.levelrail-cli login --device -
Read the template
Shows the entry, including its full compose.yaml.
levelrail-cli templates get blackbox-exporter -
Deploy it
This deploys the template compose file as an app. The app name defaults to the template id; --name sets another.
levelrail-cli templates deploy blackbox-exporter --name my-blackbox-exporter
Without a domain the app gets an sslip.io address. You can also deploy it from the dashboard: Apps, New app, Browse templates, then Blackbox Exporter.
Docs and upstream
More in Monitoring
- BeszelA lightweight server monitoring hub with historical stats for CPU, memory, disk, and network.
- BugsinkA self-hosted, lightweight error tracking server with a Sentry-compatible SDK ingestion API.
- Changedetection.ioMonitor any webpage for changes and get notified the moment content updates.
- CheckmateAn open-source uptime and server monitoring app with incident history and status pages.
- ChronografA web interface to explore, graph and alert on time series stored in InfluxDB. Add your InfluxDB connection from the first screen; it has no login of its own, so restrict who can reach it.
- AlertmanagerPrometheus Alertmanager: groups, deduplicates and routes alerts to email, Slack, webhooks and on-call tools.