Skip to content

Commit

Permalink
Update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
tulir committed Dec 20, 2023
1 parent f6053c4 commit f1a4d3b
Showing 1 changed file with 14 additions and 11 deletions.
25 changes: 14 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,18 @@
# Validation Relay
# registration-relay
A relay that helps the [iMessage bridge] fetch data from registration providers ([Mac], [iOS]).

## Build
[iMessage bridge]: https://github.com/beeper/imessage
[Mac]: https://github.com/beeper/mac-registration-provider
[iOS]: https://github.com/beeper/phone-registration-provider

Local binary:
## Usage
Build the binary (clone + `go build`) or use a Docker image from GHCR (`ghcr.io/beeper/registration-relay`),
then just run it with some environment variables for configuration.

```sh
go build ./cmd/registration_relay
```
* `REGISTRATION_RELAY_SECRET` (required) - 32 byte secret key as base64, used to authenticate providers when reconnecting.
* A secret can be generated with `openssl rand -base64 32`
* `REGISTRATION_RELAY_LISTEN` (defaults to :8000) - IP and port to listen on.
* `REGISTRATION_RELAY_METRICS_LISTEN` (defaults to :5000) - IP and port to listen on for Prometheus metrics.

Docker image:

```sh
docker build .
```
A reverse proxy configured to allow websockets should be pointed at the RELAY_LISTEN port to enable TLS.
The bridge and registration providers can then be pointed at the public address of the reverse proxy.

0 comments on commit f1a4d3b

Please sign in to comment.