Glassmkr Documentation

#What Glassmkr Monitors

Glassmkr is a monitoring agent for bare metal and dedicated servers. The agent collects hardware and OS metrics every 5 minutes and pushes them to the Glassmkr dashboard, where 38 alert rules evaluate each snapshot automatically.

38 alert rules evaluate on every collection cycle. All rules included on every plan, including Free.

#Quick Start

Docker (recommended)

# 1. Create config directory
sudo mkdir -p /etc/glassmkr

# 2. Add your collector key (get it from glassmkr.com after signing up)
sudo tee /etc/glassmkr/collector.yaml << 'EOF'
server_url: https://forge.glassmkr.com
collector_key: col_YOUR_KEY_HERE
interval: 300
EOF

# 3. Download and start
curl -O https://raw.githubusercontent.com/glassmkr/crucible/main/docker-compose.yml
docker compose up -d

# 4. Verify
docker compose logs glassmkr-crucible

The container runs with --privileged and network_mode: host for IPMI, SMART, and bond monitoring. See Security for details.

npm alternative

npm install -g @glassmkr/crucible
sudo glassmkr-crucible --config /etc/glassmkr/collector.yaml

Requires Node.js 24+. System packages smartmontools, ipmitool, dmidecode needed for full hardware monitoring.

Your server appears in the dashboard within 5 minutes.

Sign up free to get your collector key.

#Alert Rules Reference

State alerts auto-resolve when the condition clears. Event alerts (unexpected_reboot) stack occurrences and have a Resolve button. Acknowledged alerts still auto-resolve.

#Configuration Reference

# Required
server_url: https://forge.glassmkr.com
collector_key: col_YOUR_KEY_HERE

# Optional
interval: 300          # Collection interval in seconds (default: 300)
# hostname: my-server  # Override auto-detected hostname
# modules:             # Disable specific collection modules
#   ipmi: false
#   smart: false
#   zfs: false
#   security: false

server_url

The Glassmkr ingest endpoint. Always https://forge.glassmkr.com for the hosted service.

collector_key

Your server's authentication token. Generated when you add a server in the dashboard. Prefixed with col_.

interval

How often (in seconds) the agent collects and pushes a snapshot. Default is 300 (5 minutes). Minimum is 60.

hostname

Override the auto-detected hostname. Useful when the system hostname is generic or changes between reboots.

modules

Disable individual collection modules. Set any module to false to skip it. The agent will not attempt to read sensors for disabled modules.

#System Requirements

Operating System

Linux with systemd. Tested on Debian 11/12, Ubuntu 20.04 to 24.04, Rocky 8/9, AlmaLinux 8/9.

Runtime

Docker (recommended) or Node.js 24+.

Privileges

Root access required for IPMI, SMART, and /proc system reads.

Network

Outbound HTTPS on port 443 to forge.glassmkr.com. No inbound ports needed.

Resource usage

Approximately 90 MB RSS. Varies by hardware; servers with more IPMI sensors or drives use slightly more.

Optional packages (npm install only)

smartmontools, ipmitool, dmidecode for full hardware monitoring. Missing packages are silently skipped.

#How It Works

• The agent is MIT open source: github.com/glassmkr/crucible
• Agent pushes outbound only, opens no inbound ports
• Snapshots contain hardware metrics only, no user data
• Dashboard runs on EU dedicated servers, no cloud providers
• AI analysis runs on a self-hosted GPU, no external AI providers

#Notification Channels

All channels support per-priority filtering (P1 to P4). Agent update notifications send major version alerts to everyone; patch notifications are opt-in.

#Pricing

#FAQ

#Links