Auto-start

Search…
Auto-start
Configuring relay CLI to auto-start as a background service.
Webhook Relay agent can run in the background and be managed by the operating system on Linux, Windows and MacOS. To start using the background service, first get the CLI following installation instructions.
Configuration file
When running as a background service, agent needs a configuration file. It’s a simple yaml format file.
For this file, you will need to:
​generate access token key and secret.
​create a tunnel if you need bidirectional tunnels (optional)
​create a bucket if you are going to use one-way webhook forwarding (optional)
Now, populate the file:
1
version: "v1"
2
key: your-secret-key # will be encrypted on startup
3
secret: your-secret  # will be encrypted on startup
4
tunnels:
5
  - tunnel-1-name
6
  - tunnel-2-name
7
buckets:
8
  - bucket-1-name
9
  - bucket-2-name
Copied!
If no tunnels or no buckets are defined, that part of the relay service will be disabled. If no buckets and tunnels are specified, relay service will not start.
Note that you can subscribe to tunnels and buckets even before you have created them through the API/CLI/UI.
Once the relay service starts, key and secret will be encrypted.
Linux
Tu install the service, you will need to use sudo and provide a full path to relay configuration file:
1
sudo relay service install -c /full/path/config.yaml --user [YOUR USERNAME]
2
sudo relay service start
Copied!
To specify credentials during install:
1
sudo relay service install -c /full/path/config.yaml --key [YOUR KEY] --secret [YOUR SECRET]
Copied!
Restart
To restart the service (if you change the configuration file
1
sudo relay service restart
Copied!
Uninstall
To uninstall the service:
1
sudo relay service stop
2
sudo relay service uninstall
Copied!
To view service logs, use journalctl:
1
journalctl -u relay.service -f
Copied!
Windows
Make sure you have download relay CLI and created a config.yaml file.
If you are using Powershell:
1
.\relay-windows-amd64.exe service install -c .\config.yaml --user [YOUR USERNAME]
2
.\relay-windows-amd64.exe service start 
Copied!
You can also just keep the config.yaml file in the same directory as relay exe file. Then, you just need to do:
1
.\relay-windows-amd64.exe service install
2
.\relay-windows-amd64.exe service start 
Copied!
The agent is now installed and will be run after a system reboot.
To specify credentials during install:
1
.\relay-windows-amd64.exe service installl -c .\full\path\config.yaml --key [YOUR KEY] --secret [YOUR SECRET]
Copied!
Restart
To restart the service (if you change the configuration file):
1
.\relay-windows-amd64.exe service restart
Copied!
Uninstall
To uninstall the service:
1
.\relay-windows-amd64.exe service stop
2
.\relay-windows-amd64.exe service uninstall
Copied!
MacOS
Execute as the user who will run the agent:
1
relay service install -c /full/path/config.yaml -u your-user
2
relay service start
Copied!
To specify credentials during install:
1
relay service install -c /full/path/config.yaml --key [YOUR KEY] --secret [YOUR SECRET]
Copied!
Restart
To restart the service (if you change the configuration file):
1
relay service restart
Copied!
Uninstall
To uninstall the service:
1
relay service stop
2
relay service uninstall
Copied!
Note: The service needs to be installed from the Terminal by running its GUI interface as your current user. Only then will you be able to manage the service.
Using different region
By default agent connects to EU region. If you are using other region, specify it in the configuration:
1
version: "v1"
2
key: your-secret-key
3
secret: your-secret
4
region: au # Will use Australia region
5
tunnels:
6
  - tunnel-1-name
7
buckets:
8
  - bucket-1-name
Copied!
Logging
Usually logs can be viewed through journalctl:
1
journalctl -u relay.service -f
Copied!
If you are using a Windows machine, then it’s useful to specify a log output location during install:
1
.\relay.exe service install -c C:\config.yaml  --logs-output C:\relay.log 
Copied!
You can also specify logging level and output file in the configuration:
1
version: "v1"
2
key: your-secret-key
3
secret: your-secret
4
tunnels:
5
  - tunnel-1-name
6
buckets:
7
  - bucket-1-name
8
logs_output: /full/path/to/relay-agent-svc.log
9
log_level: info
Copied!
Upgrade process
If the executable has write permissions, then to update it you only need to restart the service. Otherwise, follow these steps:
1.Stop the service and uninstall it.
2.Download the new binary following installation instructions for your platform.
3.Install and start the service.
HTTP Proxy settings
Relay can use HTTP proxy to open the tunnel:
1
version: "v1"
2
key: your-secret-key
3
secret: your-secret
4
tunnels:
5
  - tunnel-1-name
6
buckets:
7
  - bucket-1-name
8
logs_output: /full/path/to/relay-agent-svc.log
9
log_level: info
10
http_proxy: http://proxy-hostname:3128
Copied!
Using with self-hosted Transponder
If you host an instance of Webhook Relay yourself (Transponder), add additional values to specify the server APIs:
1
version: "v1"
2
serverAddress: https://example.com
3
serverGRPCAddress: example.com:9302
4
serverTunnelAPIAddress: example.com:9800
5
key: your-secret-key
6
secret: your-secret
7
tunnels:
8
  - tunnel-1-name
9
buckets:
10
  - bucket-1-name
Copied!