diff --git a/docs/install/custom-server.rst b/docs/install/custom-server.rst index 1eb1bd1..5ab06fe 100644 --- a/docs/install/custom-server.rst +++ b/docs/install/custom-server.rst @@ -34,7 +34,7 @@ Pre-requisites #. A server running Ubuntu 18.04 where you have root access. #. At least **1GB** of RAM on your server. #. Ability to ``ssh`` into the server & run commands from the prompt. -#. A **IP address** where the server can be reached from the browsers of your target audience. +#. An **IP address** where the server can be reached from the browsers of your target audience. If you run into issues, look at the specific :ref:`troubleshooting guide ` for custom server installations. @@ -67,7 +67,7 @@ Step 1: Installing The Littlest JupyterHub :ref:`topic/customizing-installer` documents other options that can be passed to the installer. #. Press ``Enter`` to start the installation process. This will take 5-10 minutes, - and will say 'Done!' when the installation process is complete. + and will say ``Done!`` when the installation process is complete. #. Copy the **Public IP** of your server, and try accessing ``http://`` from your browser. If everything went well, this should give you a JupyterHub login page. diff --git a/docs/troubleshooting/providers/custom.rst b/docs/troubleshooting/providers/custom.rst index a8134e0..8caf112 100644 --- a/docs/troubleshooting/providers/custom.rst +++ b/docs/troubleshooting/providers/custom.rst @@ -7,6 +7,9 @@ Troubleshooting issues on your own server This is an incomplete list of issues people have run into when installing TLJH on their own servers, and ways they have fixed them. +Before trying any of them, also consider whether turning your machine on and off +and/or deleting the VM and starting over could solve the problem; +it has done so on a surprisingly high number of occasions! Outgoing HTTP proxy required ============================ @@ -27,4 +30,4 @@ certificates to use. .. code:: export REQUESTS_CA_BUNDLE= - sudo npm config set cafile= \ No newline at end of file + sudo npm config set cafile=