Webhookrelayd 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 https://my.webhookrelay.com/buckets and create a bucket
- Configure output destination (another container or IP address where you want to forward)
- Start a webhookrelayd agent:
docker run -it webhookrelay/webhookrelayd -k [access key] -s [access secret] -b mybucketname
You can also specify configuration through environment variables:
KEY=<your token key> SECRET=<your token secret> BUCKET=<bucket filter>
If you are using self-signed certificates on your internal side, specify
INSECURE environment variable to skip validation:
Open a tunnel
- Go to https://my.webhookrelay.com/tunnels and create a tunnel with your desired destination
- Start a bidirectional tunnel:
docker run --name whr-relayd \ --net host \ --restart always \ -d webhookrelay/webhookrelayd:latest \ --mode tunnel -t mytunnelname -k [access key] -s [access secret]
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:
KEY=<your token key> SECRET=<your token secret> TUNNELS=<comma separated list of tunnels> REGION=<region - eu, au, us-west (defaults to eu)>