Webhook Client

A minimal Express.js server that logs incoming webhook requests to the console, with Docker support.

Features

• POST /webhook endpoint that logs headers + body
• Health check at /health
• Auto-reload in development (using Nodemon)
• Dockerized for easy deployment

🚀 Quick Deployment (Docker Hub)

Pre-built image available on Docker Hub:

# Pull and run the latest version
docker run -p 3000:3000 -d rocardho/webhook-client:latest

# Or specify a version
docker run -p 3000:3000 -d rocardho/webhook-client:1.0.0

Quick Start

Without Docker

1. Install dependencies:

   npm install

2. Start the server:

    npm start       # Production
    npm run dev     # Development (auto-reload)
   

With Docker

1. Build the image::

   docker build -t webhook-client .

2. Run the container:

    docker run -p 3000:3000 -d --name webhook-client webhook-client
   

Usage

Send a test webhook:

curl -X POST http://localhost:3000/webhook \
  -H "Content-Type: application/json" \
  -d '{"event": "test", "data": {"key": "value"}}'

View Logs

# Local
npm start

# Docker
docker logs -f webhook-client

Endpoints

Route	Method	Description
/webhook	POST	Receives and logs webhook data
/health	GET	Returns {"status":"healthy"}