Pinger

← Back to Docs

Docker Agent Guide

Deploy lightweight headless monitoring agents with Docker containers

When to Use Docker

Prerequisites

✓ Docker Installed

Docker Engine 20.10+ or Docker Desktop

✓ Pinger Account

Sign up at ping.wbmtek.com (free)

✓ API Key

Get your API key from the dashboard

Quick Start

1. Get Your API Key

  1. Sign in to ping.wbmtek.com
  2. Go to Settings
  3. Copy your API key

2. Run the Container

docker run -d \
  --name pinger-agent \
  --restart unless-stopped \
  -e API_KEY=your_api_key_here \
  -e SITE_NAME="My Office" \
  140375608410.dkr.ecr.us-east-1.amazonaws.com/pinger-agent:latest

Replace your_api_key_here with your actual API key

3. Add Devices

Go to the web dashboard:

  1. Find your new agent in the list
  2. Click on it to view details
  3. Click "Add Device"
  4. Enter device name and IP address
  5. Start monitoring!

Docker Compose

For easier management, use Docker Compose:

docker-compose.yml

version: '3.8'

services:
  pinger-agent:
    image: 140375608410.dkr.ecr.us-east-1.amazonaws.com/pinger-agent:latest
    container_name: pinger-agent
    restart: unless-stopped
    environment:
      - API_KEY=your_api_key_here
      - SITE_NAME=My Office
      - CHECK_INTERVAL=30  # Optional: seconds between checks (default: 30)
    network_mode: host  # Required for local network device monitoring

Commands

# Start the agent
docker-compose up -d

# View logs
docker-compose logs -f

# Stop the agent
docker-compose down

# Update to latest version
docker-compose pull
docker-compose up -d

Environment Variables

VariableRequiredDescription
API_KEYYesYour Pinger API key from dashboard
SITE_NAMENoFriendly name for this location
CHECK_INTERVALNoSeconds between device checks (default: 30)

Troubleshooting

Agent not appearing in dashboard

  • Check logs: docker logs pinger-agent
  • Verify API key is correct
  • Ensure container has internet access
  • Wait up to 30 seconds for first heartbeat

Can't ping local devices

  • Use network_mode: host in docker-compose
  • Or use --network host flag
  • Verify devices respond to ping from host machine

Container keeps restarting

  • Check logs for error messages
  • Verify API_KEY environment variable is set
  • Ensure image pulled successfully

💡 Pro Tips

← Desktop AppGet Started →