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 behind proxy #230

Merged
merged 8 commits into from
Dec 3, 2018
Merged

Documentation behind proxy #230

Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
1cb30f8
Update custom-server.rst
fm75 Oct 30, 2018
498a1cb
Update custom-server.rst
fm75 Nov 3, 2018
eb68a80
Update custom-server.rst
fm75 Nov 27, 2018
988f198
Update custom-server.rst
fm75 Nov 28, 2018
bcc9014
Create temp-log-example
fm75 Nov 28, 2018
553e75a
Update custom-server.rst
fm75 Nov 28, 2018
24a0c86
Delete temp-log-example
fm75 Nov 28, 2018
339bb83
Update custom-server.rst
fm75 Nov 28, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
23 changes: 19 additions & 4 deletions docs/install/custom-server.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,19 +23,34 @@ Pre-requisites
#. Some familiarity with the command line.
#. A server running Ubuntu 18.04 where you have root access.
#. Ability to ``ssh`` into the server & run commands from the prompt.
#. A **public IP** where the server can be accessed from the internet.
#. A **IP address** where the server can be reached from the browsers of your target audience.

Step 1: Installing The Littlest JupyterHub
==========================================

#. Using a terminal program, SSH into your server. This should give you a prompt where you can
type commands.

#. If your server is behind a firewall and needs a proxy to reach the internet:

.. code-block:: bash

export http_proxy=<your_proxy>
fm75 marked this conversation as resolved.
Show resolved Hide resolved

#. Some requests will fail if your certs are self-signed. Copy the text below and paste it
into the terminal after replacing ``</directory/with/your/ssl/certificates>``
with the **path of the directory containing your ssl certificates** (don't include the brackets!).:

.. code::

export REQUESTS_CA_BUNDLE=</directory/with/your/ssl/certificates>
sudo npm config set cafile=</directory/with/your/ssl/certificates>

#. Make sure you have ``Python3``, ``curl`` and ``git`` installed. On latest Ubuntu you can get all of these with:

.. code::
.. code::

apt-get install python3 git curl
apt-get install python3 git curl

#. Copy the text below, and paste it into the terminal. Replace
``<admin-user-name>`` with the name of the first **admin user** for this
Expand All @@ -45,7 +60,7 @@ Step 1: Installing The Littlest JupyterHub

.. code-block:: bash

curl https://raw.githubusercontent.com/jupyterhub/the-littlest-jupyterhub/master/bootstrap/bootstrap.py | sudo python3 - --admin <admin-user-name>
curl https://raw.githubusercontent.com/jupyterhub/the-littlest-jupyterhub/master/bootstrap/bootstrap.py | sudo -E python3 - --admin <admin-user-name>

.. note::

Expand Down