RequestBin

Self-hosted HTTP request inspector for debugging webhooks and APIs.

Originally Created by Jeff Lindsay

License

MIT

Local Development

You should have uv installed locally if you want to run the application outside of docker.

Quick Start

# Install dependencies and run
uv sync
uv run python web.py

# The application will be available at http://localhost:4000

Alternative: Virtual Environment

# Install dependencies
uv sync

# Activate virtual environment
source .venv/bin/activate  # macOS/Linux
# or .venv\Scripts\activate  # Windows

# Run the application
python web.py

Local Development with Redis

# Start Redis in Docker (optional, for testing with persistent storage)
docker run -d -p 6379:6379 redis:7-alpine

# Run with Redis backend
REALM=prod REDIS_URL=redis://localhost:6379 uv run python web.py

Development Commands

# Add new dependencies
uv add <package-name>

# Add development dependencies
uv add --dev <package-name>

# Update all dependencies
uv sync

Docker Deployment

Requirements: Docker and Docker Compose

# Build and start the containers
docker compose up

# The application will be available at http://localhost:8000

Environment Variables

• ROOT_URL: Base URL for the application (default: http://localhost:8000)
• REDIS_URL: Redis connection string (default: redis://redis:6379)
• SESSION_SECRET_KEY: Flask session secret key
• BIN_TTL: Bin expiration time in seconds (default: 48 hours)
• MAX_REQUESTS_STORED: Maximum requests per bin (default: 50)

Contributors

• Joshua Flanagan [email protected] (updated for python3)
• Barry Carlyon [email protected]
• Jeff Lindsay [email protected]