skooh/proxy

•Updated 7 months ago

Image

1.3K

skooh/proxy repository overview

⁠Skooh Proxy

Receive webhooks on your local machine without exposing it to the internet.

Skooh⁠ is a webhook forwarding service that lets you receive webhooks from services like Stripe, GitHub, Slack, and more directly on your local development machine or internal servers—no public IP or tunneling required.

This proxy connects to the Skooh API and forwards incoming webhooks to your local services in real-time.

⁠Quick Start

⁠Using Docker

docker run -d \
  --name skooh-proxy \
  -e API_URL=https://api.skooh.io \
  skooh/proxy \
    --token your_hook_token \
    --api-key your_api_key \
    --internal-webhook-url http://host.docker.internal:8080/webhook

⁠Using Python

pip install -r requirements.txt

python -m skooh_proxy \
    --token your_hook_token \
    --internal-webhook-url http://localhost:8080/webhook \
    --api-key your_api_key

⁠Configuration

Get your Hook Token and API Key from your Skooh dashboard⁠.

⁠Environment Variables

Variable	Default	Description
`API_URL`	`https://api.skooh.io`	Skooh API URL
`API_KEY`	-	Your Skooh API key (user ID is auto-discovered from this)
`TOKEN`	-	Your webhook hook token (can also use `--token`)
`INTERNAL_WEBHOOK_URL`	-	Local URL to forward webhooks to (can also use `--internal-webhook-url`)
`USER_ID`	-	Your Skooh user ID (optional, auto-discovered from API key if not provided)

⁠Command Line Arguments

Argument	Required	Description
`--token`	Yes	Your webhook hook token from Skooh
`--internal-webhook-url`	Yes*	Local URL to forward webhooks to
`--api-key`	Yes	Your Skooh API key (user ID is auto-discovered from this)
`--method`	No	HTTP method for forwarding (default: POST)
`--mode`	No	Connection mode: `auto`, `websocket`, or `http`
`--log-only`	No	Log webhooks without forwarding them
`--user-id`	No	Your Skooh user ID (auto-discovered from API key if not provided)

* Not required if --log-only is enabled.

⁠Log-Only Mode

Use --log-only to receive and log webhooks without forwarding them to a local service. Useful for debugging or monitoring webhooks.

python -m skooh_proxy \
    --token your_hook_token \
    --api-key your_api_key \
    --log-only

⁠Features

Real-time delivery via WebSocket with automatic HTTP polling fallback
Multi-platform Docker images for linux/amd64 and linux/arm64
Message replay to recover missed webhooks on reconnection

⁠Links

Website: https://skooh.io⁠
Documentation: https://skooh.io/docs⁠
Dashboard: https://skooh.io/hooks⁠

⁠License

This software is proprietary and commercially licensed. Unauthorized copying, modification, distribution, or use of this software, via any medium, is strictly prohibited without express written permission from Skooh.

For licensing inquiries, please contact [email protected]⁠.

Tag summary

Recent tags

Content type

Image

Digest

sha256:c5bd9a2bd…

Size

48.2 MB

Last updated

7 months ago

docker pull skooh/proxy