Reveal Server

Installation

Install dependent packages with npm:

npm i

Or build a Docker image:

docker build -t reveal-serve .

Usage

Run on your server. Specify a secret with the s option. Create a webhook that fires on the "push" event.

Ensure that your repo has a "website" configured. The last component of this path will be used on the server.

Docker

There are some environment variables that can be used to configure the server:

• RV_PREFIXES: A comma-separated list of acceptable prefixes. For example, to allow GitHub, set RV_PREFIXES=https://github.com, or to enable only your repo set RV_PREFIXES=https://github.com/username/. If a prefix does not match, it will not be loaded.
• RV_SECRET: The contents of a secret that is shipped as part of the webhook.
• RV_LISTEN_PORT: The port number to listen to. Defaults to 9119.
• RV_LISTEN_ADDR: The local address to listen to. Defaults to 0.0.0.0
• RV_ROOT: The root where all repos will go to.

An example invocation would be:

mkdir repo-root && chown 1000 repo-root
docker run \
    -d \
    --restart unless-stopped \
    --log-opt max-size=10m \
    --name=reveal-serve \
    -p 9119:80 \
    -e RV_PREFIXES=https://github.com/example \
    -e RV_SECRET=rvsecretkey \
    -e RV_ROOT=/data \
    -v $(pwd)/repo-root:/data \
    reveal-serve