Docker container
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/.
Forward webhooks
- 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:
INSECURE=true
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)>