datasette-x-forwarded-host by simonw

15 downloads this week        Star

README source code


PyPI Changelog Tests License

Treat the X-Forwarded-Host header as the Host header


Install this plugin in the same environment as Datasette.

$ datasette install datasette-x-forwarded-host


Once installed, Datasette will replace the host header with the content of the incoming x-forwarded-host header.

This helps Datasette generate links to new pages that work when hosted behind a proxy that rewrites the host header.

Only use this plugin in deployment environmens where you know the x-forwarded-host header can be trusted!

This has been tested on GitHub Codespaces and GitPod.


To set up this plugin locally, first checkout the code. Then create a new virtual environment:

cd datasette-x-forwarded-host
python3 -mvenv venv
source venv/bin/activate

Or if you are using pipenv:

pipenv shell

Now install the dependencies and test dependencies:

pip install -e '.[test]'

To run the tests: