Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Documentation: Adds deployment instructions for Apache2 as reverse proxy #1418

Merged
merged 2 commits into from
Nov 14, 2023
Merged

Documentation: Adds deployment instructions for Apache2 as reverse proxy #1418

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1b409d3
Document an Apache 2 deployment
nbareil Nov 10, 2023
feb6bc4
fmt
nbareil Nov 10, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 35 additions & 0 deletions docs/deploy.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -376,6 +376,41 @@ journalctl -u voila.service

For more information, you can also follow [the guide on the nginx blog](https://www.nginx.com/blog/using-free-ssltls-certificates-from-lets-encrypt-with-nginx/).

### Using Apache2 as reverse proxy

Apache can also be used to serve voilà. These Apache modules need to be installed and enabled:
- mod_proxy
- mod_rewrite
- mod_proxy_http
- mod_proxy_wstunnel

With the following configuration:

```
<VirtualHost *:443>
# ...
ProxyRequests Off
ProxyPreserveHost Off

<LocationMatch "/voila/">
RewriteEngine on
RewriteCond %{REQUEST_URI} /voila/api/kernels/
RewriteRule .*/voila/(.*) "ws://127.0.0.1:50001/voila/$1" [P,L]
ProxyPreserveHost On
ProxyPass http://127.0.0.1:50001/voila/
ProxyPassReverse http://127.0.0.1:50001/voila/
</LocationMatch>
</VirtualHost>
```

For the record, Voila was instanciated with the following command line:

```
$ voila --autoreload=True --port=50001 --base_url=/voila/
```

And clients can access the instance using https://myhost/voila/

## Sharing Voilà applications with ngrok

[ngrok](https://ngrok.com) is a useful tool to expose local servers to the public internet over secure tunnels.
Expand Down
Loading