You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Sean Cross a8407e3ffe README: add note for saving repo root
Signed-off-by: Sean Cross <>
4 years ago
.dockerignore dockerignore: make it a copy of gitignore 4 years ago
.gitignore gitignore: add swp/swo and repo root 4 years ago
Dockerfile Dockerfile: don't run as root 4 years ago
LICENSE LICENSE: add file 4 years ago README: add note for saving repo root 4 years ago
index.js index: one more tiny printing change 4 years ago
package-lock.json cmdline: add arguments 4 years ago
package.json package: add repository, license, author 4 years ago

Reveal Server


Install dependent packages with npm:

npm i

Or build a Docker image:

docker build -t reveal-serve .


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.


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=, or to enable only your repo set RV_PREFIXES= 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
  • 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= \
    -e RV_SECRET=rvsecretkey \
    -e RV_ROOT=/data \
    -v $(pwd)/repo-root:/data \