Docker
Docker is the most popular way to run Webhook Relay agent to forward webhooks and open tunnels.
Last updated
Was this helpful?
Docker is the most popular way to run Webhook Relay agent to forward webhooks and open tunnels.
Last updated
Was this helpful?
Webhook Relay agent can either forward requests to destinations or open bidirectional tunnels. It is a single Docker image that requires access key and secrets for authentication. This image can be used either in a single machine or in cluster schedulers such as Kubernetes.
If you don't have Docker installed, we highly recommend checking resources available on https://www.docker.com/.
Go to and create a bucket
Configure output destination (another container or IP address where you want to forward)
Go to and get your access key and secret
Start the agent:
You can also specify configuration through environment variables:
If you are using self-signed certificates on your internal side, specify INSECURE
environment variable to skip validation:
If you are behind a VPN or a firewall that doesn't allow egress gRPC traffic to my.webhookrelay.com:8080, then add environment variable to use WebSocket transport:
Start a tunnel:
Here webhookrelayd commands:
–mode tunnel indicates that it should start bidirectional tunnel
-t mytunnelname acts as a filter, it has to match the tunnel name that you have created previously
-k [access key] is your authentication token key
-s [access secret] is your authentication token secret
You can also specify these details through environment variables:
Go to and create a tunnel with your desired destination
Go to and get your access key and secret