Webhook Relay
PricingLogin
  • Introduction
  • Quick Start - Forwarding
  • Quick Start - Tunnels
  • 🛠️Installation
    • Relay CLI
      • Install
      • Auto-start
      • Run config.yaml reference
    • Containerized
      • Kubernetes Installation
      • Podman
      • Docker
      • Docker Compose
  • Products
    • 🛰️Webhook Forwarding
      • Glossary
      • WebSocket Server
      • Authentication
      • Custom Domains
    • ⚡Functions
      • Managing functions
      • Edit request/response
      • Working with JSON
      • 🦾Advanced
        • Working with time
        • Testing functions in CLI
        • Making HTTP Requests
        • Multipart Form Data
        • URLEncoded Form Data
        • GCP BigQuery
        • Sending Emails
        • JWT authentication
        • Base64, Hashes, Encryption
      • 🤖Integrating into CI/CD
    • 🔃Tunnels
      • Using tunnels
      • Custom Domains
      • Encryption (HTTPS)
      • Regions
  • 📝Examples
    • Intro to examples
    • Webhooks
      • Receiving webhooks on localhost
      • Receive webhooks inside your JavaScript app
      • Execute shell scripts on remote machines
    • Functions
      • Enrich webhooks from 3rd party APIs
      • Convert DockerHub webhook to Slack notification
      • Allowing only POST requests through
      • Manipulate webhook request body
    • Tunnels
      • Ingress for any Kubernetes environment
      • Demoing your website
    • 🏠Home Automation
      • Home Assistant
      • Node-RED
      • Raspberry Pi
  • Platform
    • CLI Basics
    • Using CLI Behind Proxy
    • Self-hosting Server
      • Server deployment
      • Client configuration
    • Security & Tech
Powered by GitBook
On this page
  • Forward webhooks
  • Open a tunnel

Was this helpful?

  1. Installation
  2. Containerized

Podman

Podman is a popular Docker alternative that can run containers.

PreviousKubernetes InstallationNextDocker

Last updated 2 years ago

Was this helpful?

Running Webhook Relay container with is very similar to Docker instructions. However, key difference will be the image, instead of webhookrelay/webhookrelayd:latest please use docker.io/webhookrelay/webhookrelayd-ubi8:latest.

Forward webhooks

  1. Go to and create a bucket

  2. Configure output destination (another container or IP address where you want to forward)

  3. Get access token from . Once you click on ‘Create Token’, it will generate it and show a helper to set environment variables:

export RELAY_KEY=*****-****-****-****-*********
export RELAY_SECRET=**********
export BUCKETS=your-buckets-name
export DESTINATION=<destination output ID, name or URL to filter on>
  1. Start a webhookrelayd agent:

podman run -d --env RELAY_KEY=$RELAY_KEY \
  --env RELAY_SECRET=$RELAY_SECRET \
  --env BUCKETS=$BUCKETS \
  --network host webhookrelay/webhookrelayd-ubi8

If you are using self-signed certificates on your internal side, specify INSECURE environment variable to skip validation:

INSECURE=true

Open a tunnel

export RELAY_KEY=*****-****-****-****-*********
export RELAY_SECRET=**********
export TUNNELS=your-tunnel-name
export REGION=<region - eu, au, us-west (defaults to eu)>
  1. Start a bidirectional tunnel:

podman run -d --env RELAY_KEY=$RELAY_KEY \
  --env RELAY_SECRET=$RELAY_SECRET \ 
  --env TUNNELS=$TUNNELS \
  --env REGION=$REGION \
  --network host webhookrelay/webhookrelayd-ubi8

Go to and create a tunnel with your desired destination

Get access token from . Once you click on ‘Create Token’, it will generate it and show a helper to set environment variables:

🛠️
Podman
https://my.webhookrelay.com/buckets
here
https://my.webhookrelay.com/tunnels
here