Podman

Podman is a popular Docker alternative that can run containers.

Running Webhook Relay container with Podman 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 https://my.webhookrelay.com/buckets and create a bucket

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

  3. Get access token from here. 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

  1. Go to https://my.webhookrelay.com/tunnels and create a tunnel with your desired destination

  2. Get access token from here. 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 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

Last updated