Skip to content

Commit

Permalink
Add bit more info on troubleshooting HTTPS
Browse files Browse the repository at this point in the history
We no longer use CHP, so add section on getting logs from
traefik instead
  • Loading branch information
yuvipanda committed May 20, 2019
1 parent a569417 commit 9f776c2
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 7 deletions.
6 changes: 6 additions & 0 deletions docs/howto/admin/https.rst
Original file line number Diff line number Diff line change
Expand Up @@ -97,3 +97,9 @@ Finally, you can reload the proxy to load the new configuration::
sudo tljh-config reload proxy

and now access your Hub securely at https://yourhub.yourdomain.edu.

Troubleshooting
===============

If you're having trouble with HTTPS, looking at the :ref:`traefik
proxy logs <troubleshooting/logs/traefik>` might help.
16 changes: 9 additions & 7 deletions docs/troubleshooting/logs.rst
Original file line number Diff line number Diff line change
Expand Up @@ -44,18 +44,20 @@ logs is a great first step.
This command displays logs from JupyterHub itself. See :ref:`journalctl_tips`
for tips on navigating the logs.

Configurable HTTP Proxy Logs
============================
.. _troubleshooting/logs/traefik:

Configurable HTTP Proxy redirects traffic to JupyterHub / user notebook servers
as necessary & handles HTTPS. It usually is the least problematic of the components,
but things do go wrong sometimes!
Traefik Proxy Logs
==================

`traefik <https://traefik.io/>`_ redirects traffic to JupyterHub / user notebook servers
as necessary & handles HTTPS. Look at this if all you can see in your browser
is one line cryptic error messages, or if you are having trouble with HTTPS.

.. code-block:: bash
sudo journalctl -u configurable-http-proxy
sudo journalctl -u traefik
This command displays logs from Configurable HTTP Proxy. See :ref:`journalctl_tips`
This command displays logs from Traefik. See :ref:`journalctl_tips`
for tips on navigating the logs.

User Server Logs
Expand Down

0 comments on commit 9f776c2

Please sign in to comment.