Docker

You will need a server/instance that can run Docker (recommended a standard variant of Linux).

If you need to install Docker you can follow the instructions for your OS type here: https://docs.docker.com/install​

You will also need docker-compose installed. Instructions can be found here: https://docs.docker.com/compose/install​

Tarball Extraction

Download the proxy package tarball to your server from the link provided by PullRequest.

Extract the tarball into a directory (recommended in the user home that you're installing to). This will create the ~/pullrequest_proxy/ directory. (see below)

~/pullrequest_proxy/
  ./start.sh
  ./start_with_tls.sh
  ./stop.sh
  ./status.sh
  ./proxy.tar.gz
  ./data/    # this is where all of your persistent data is stored
    ./logs/
      ./proxy.log
      ./audit.log
      ./postgres/
    ./tls/  # directory containing tls certificates if using start-with-tls.sh
      ./cert.pem
      ./key.pem

Starting the Proxy

If you are running as a non-root user, cd into the pullrequest_proxy folder and run the following:

mkdir -p ./data/{app,logs,postgres,tls,diffs}
chown -R 2000:2000 ./data

Run ./start.sh. You can either make the script executable or just run it with:

bash start.sh

This should start your proxy running at:

http://<YOUR_SERVER>:5012

Visit that site to access the PullRequest Proxy Installation Page.

Troubleshooting

If your proxy is not starting when running the start.sh script and is printing out docker-compose help instructions then you can try editing the start.sh script by removing the -V argument from the line starting with docker-compose ... .

If the logs don't seem to indicate any errors, but the page is still not loading, then you may want to check your network settings for this server to make sure that port 5012 allows incoming connections.

​