You can set various environment variables to configure bouncer before running it in production or development:
- CHROME_EXTENSION_ID
The ID of the Hypothesis Chrome extension that bouncer will communicate with (default: the ID of the official Hypothesis Chrome extension)
- DEBUG
If
DEBUG
is set (to any value) then tracebacks will be printed to the terminal for any unexpected Python exceptions. If there is noDEBUG
variable set in the environment then unexpected Python exceptions will be reported to Sentry and a generic error page shown to the user.- ELASTICSEARCH_URL
The url (host and port) of the Elasticsearch server that bouncer will read annotations from (default: http://localhost:9200)
- ELASTICSEARCH_INDEX
The name of the Elasticsearch index that bouncer will read annotations from (default: hypothesis)
- HYPOTHESIS_AUTHORITY
The domain name of the Hypothesis service's first party authority. This is usually the same as the domain name of the Hypothesis service (default: localhost).
- HYPOTHESIS_URL
The URL of the Hypothesis front page that requests to bouncer's front page will be redirected to (default: https://hypothes.is)
- SENTRY_DSN
The DSN (Data Source Name) that bouncer will use to report crashes to Sentry
- STATSD_HOST
The host of the statsd server that bouncer will report stats to (default: localhost)
- STATSD_PORT
The port of the statsd server that bouncer will report stats to (default: 8125)
- STATSD_PREFIX
A string prefix that bouncer will prepend to all metric paths reported to statsd (default: none). We recommend
export STATSD_PREFIX=bouncer
so that all bouncer's metrics will start withbouncer
.- VIA_BASE_URL
The base URL of the Via service that bouncer will redirect users to if they don't have the Hypothesis Chrome extension installed (default: https://via.hypothes.is)
Requirements:
Build the hypothesis/bouncer
Docker image and run bouncer in a Docker container:
git clone https://github.com/hypothesis/bouncer.git
cd bouncer
make docker
docker run -p 8000:8000 hypothesis/bouncer
Requirements:
Install:
git clone https://github.com/hypothesis/bouncer.git
cd bouncer
virtualenv -p python3.5 .
. bin/activate
make deps
Run the tests:
make test
To debug the JavaScript tests in a browser, run:
./node_modules/karma/bin/karma start --no-single-run karma.config.js
and open http://localhost:9876/ in your browser.
To run a dev instance on port 8000:
export CHROME_EXTENSION_ID=<id_of_your_local_dev_build_of_the_hypothesis_chrome_extension>
make dev