diff --git a/docs/images/providers/digitalocean/resize-droplet.png b/docs/images/providers/digitalocean/resize-droplet.png new file mode 100644 index 0000000..bc33a88 Binary files /dev/null and b/docs/images/providers/digitalocean/resize-droplet.png differ diff --git a/docs/install/digitalocean.rst b/docs/install/digitalocean.rst index a1e7041..f79cc52 100644 --- a/docs/install/digitalocean.rst +++ b/docs/install/digitalocean.rst @@ -117,3 +117,51 @@ Step 3: Install conda / pip packages for all users ================================================== .. include:: add_packages.txt + +Step 4: Resizing and editing the droplet +======================================== + +#. As you are using your JupyterHub, you may find that you need more memory, + disk space, or CPUs. Digital Ocean servers can be resized in the + "Resize Droplet" panel. + + .. image:: ../images/providers/digitalocean/resize-droplet.png + :alt: Resize panel of digital ocean + +#. You will need to tell the JupyterHub to make use of these new resources. + To accomplish this, you will follow the instructions in :ref:`topic/tljh-config` + to set memory limits and reload the hub. This can be completed using the terminal + in the JupyterHub, as in Step 3. It can also be completed through the Digital Ocean + console. + +#. TLJH configuration options can be verified by viewing the tljh-config output. + + .. code-block:: bash + + sudo tljh-config show + + +#. If you have changed your memory availability successfully, this will be reflected + in the `nbresuse `_ extension in the upper-right + when you open a Jupyter notebook on the Hub. + + .. image:: ../images/nbresuse.png + :alt: nbresuse demonstration + +#. If you have changed the number of cores, this can be verified at the command line. + ``nproc`` displays the number of available cores, and should be equal to the + number of cores you selected in the "Resize Droplet" panel. + + .. code-block:: bash + + nproc --all + + +#. Disk space changes can be verified, as well. The ``df`` command shows how much disk + space is available. The ``-hT`` argument allows us to have this printed in a human readable + format, and condenses the output to show one storage volume. + + .. code-block:: bash + + df -hT /home +