Deploy Webhook Debugger & Logger: Apify or self-hosted

Webhook Debugger & Logger runs in two modes: on the Apify platform, where you get a public webhook URL within seconds, or self-hosted via Node.js or Docker for environments where you control the infrastructure. Choose the path that fits your workflow.

Apify platform
Node.js
Docker

Run on Apify

The Apify platform is the fastest way to get a live webhook endpoint. No installation, no port forwarding — Apify handles the public URL and storage for you.

Open the actor in the Apify Store

Go to apify.com/ar27111994/webhook-debugger-logger and click Try for free.

Configure your input

Set your preferred options in the input form. A minimal configuration to get started:

{
  "urlCount": 3,
  "retentionHours": 24,
  "enableJSONParsing": true,
  "maskSensitiveData": true
}

See Input reference for all available options.

Start the actor

Click Start. The actor generates your webhook endpoints immediately and exposes them through the Apify web server URL.

Find your webhook URLs

Once the actor is running, open the web server URL and call /info to retrieve your active webhook endpoints and the full API surface.

Keep the actor warm with Apify Standby mode so your webhook endpoints stay ready for incoming traffic without paying a cold-start penalty on each request. This is especially useful for long-running debug sessions or when you need the endpoint available on demand.

Self-host with Node.js

Run the server directly with Node.js if you have the runtime available and want the simplest local setup.Requirements: Node.js 20 or later.

Clone the repository and install dependencies

git clone https://github.com/ar27111994/webhook-debugger-logger.git
cd webhook-debugger-logger
npm install

Configure your environment

Copy .env.example to .env and set your preferred values:

cp .env.example .env

At minimum, you can set the actor input via the INPUT variable:

ACTOR_WEB_SERVER_PORT=8080
INPUT={"urlCount":3,"retentionHours":24,"authKey":"your-secret-key"}
APIFY_LOCAL_STORAGE_DIR=./storage

Start the server

npm start

The server listens on http://localhost:8080 by default. Open /info to confirm it is running and to retrieve your webhook URLs.

Self-host with Docker

Use Docker to run a self-contained, production-ready container without installing Node.js locally.

Build the image

docker build -t webhook-debugger-logger .

The default build target produces the standard image. To build the standalone target explicitly:

docker build --target runtime-standalone -t webhook-debugger-logger .

Run the container

docker run --rm -p 8080:8080 \
  -e ACTOR_WEB_SERVER_PORT=8080 \
  -e APIFY_LOCAL_STORAGE_DIR=/app/storage \
  webhook-debugger-logger

Pass your actor input as the INPUT environment variable to configure the run:

docker run --rm -p 8080:8080 \
  -e ACTOR_WEB_SERVER_PORT=8080 \
  -e APIFY_LOCAL_STORAGE_DIR=/app/storage \
  -e INPUT='{"urlCount":3,"retentionHours":24,"authKey":"your-secret-key"}' \
  webhook-debugger-logger

Verify the server is ready

The container exposes a /ready endpoint you can use to confirm startup:

curl http://localhost:8080/ready

Then call /info to retrieve your active webhook URLs and the full API surface.

Environment configuration

These are the key environment variables for both Node.js and Docker deployments.

Variable	Purpose	Default
`ACTOR_WEB_SERVER_PORT`	HTTP port the server listens on	`8080`
`INPUT`	Full actor input as a JSON string — sets `urlCount`, `retentionHours`, `authKey`, and all other options	unset
`APIFY_LOCAL_STORAGE_DIR`	Directory for captured events, webhook state, and large payload offloads	`./storage`
`LOG_LEVEL`	Logging verbosity (`info`, `debug`, `warn`, `error`)	`info`

For the full list of environment variables and advanced tuning options, see Environment variables.

Generated webhook URLs are public unless you set authKey, allowedIps, or signatureVerification in your input. Do not point sensitive production traffic at unsecured endpoints.

Get Started

Core Features

Security

Configuration

Guides

Help

Deploy Webhook Debugger & Logger: Apify or self-hosted

Run on Apify

Self-host with Node.js

Self-host with Docker

Environment configuration

Get Started

Core Features

Security

Configuration

Guides

Help

Documentation Index

​Run on Apify

​Self-host with Node.js

​Self-host with Docker

​Environment configuration

Run on Apify

Self-host with Node.js

Self-host with Docker

Environment configuration