Simple Web App

A flexible monitoring web application for infrastructure practice. Test connectivity, monitor system resources, and explore network configurations.

Features

• 🔌 Service Connectivity: Test host:port combinations
• 📊 System Monitoring: Real-time metrics via Glances
• 🌐 Network Scanning: Port scanning (private networks only)
• 📝 Configurable: JSON service configuration
• 🐳 Production Ready: Health checks, logging, Docker deployment

Quick Start

# Basic deployment
docker run -d -p 80:80 -p 61208:61208 --name simple-webapp \
  ghcr.io/patrick204nqh/simple-webapp:latest

# With custom services configuration
docker run -d -p 80:80 -p 61208:61208 \
  -v /path/to/services.json:/app/config/services.json:ro \
  --name simple-webapp ghcr.io/patrick204nqh/simple-webapp:latest

Access: Web UI • Glances • Health

Screenshots

Dashboard

Glances

Configuration

Create services.json to define monitored services:

{
  "services": [
    {
      "name": "my-database",
      "host": "192.168.1.100", 
      "port": 5432,
      "type": "tcp"
    }
  ]
}

Mount to /app/config/services.json in container.

API Endpoints

Method	Endpoint	Description
GET	/	Web UI
GET	/health	Health check
GET	/ready	Readiness probe
GET	/api/instance-info	System metadata
GET	/api/services	Configured services
POST	/api/check-service	Test connectivity
POST	/api/network-scan	Port scanning

Use Cases

• Infrastructure Practice: Monitor AWS EC2 instances and services
• Development: Check local Docker containers and services
• Network Troubleshooting: Test connectivity and diagnose issues
• Learning: Understand networking, monitoring, and containerization

Development

docker compose build && docker compose up

Access: Web UI • Glances

Why Simple Web App?

✅ Zero dependencies - No database required
✅ Instant deployment - Single Docker command
✅ Production ready - Health checks and monitoring
✅ Security focused - Private network scanning only