Skip to content

Commit

Permalink
Better description of User Directory (#92)
Browse files Browse the repository at this point in the history
  • Loading branch information
jbusecke authored Dec 14, 2023
1 parent 2ba1514 commit b71b0a0
Showing 1 changed file with 16 additions and 0 deletions.
16 changes: 16 additions & 0 deletions book/leap-pangeo/jupyterhub.md
Original file line number Diff line number Diff line change
Expand Up @@ -121,6 +121,22 @@ To help onboard you to this new way of working, we have written a guide to Files

We recommend you read this thoroughly, especially the part about Git and GitHub.

(hub:data:user_dir)=
#### Your User Directory

When you open your hub, you can navigate to the "File Browser" and see all the files in your User Directory
<img width="442" alt="image" src="https://github.com/leap-stc/leap-stc.github.io/assets/14314623/3ba6b45a-a077-4824-b0ec-9c111af50c33">

Your User Directory behaves very similar to a filestystem on your computer. If you save a file from a notebook, you will see it appear in the File Browser (you might have to wait a few seconds or press refresh) and you can use a terminal to navigate the terminal as you would on a UNIX machine:

<img width="357" alt="image" src="https://github.com/leap-stc/leap-stc.github.io/assets/14314623/a84c12e2-9f8a-4de1-a3e3-feff1bf59061">

:::{note}
As shown in the picture above, every user will see `'/home/jovyan'` as their root directory. This is different from many HPC accounts where your home directory will point to a directory with your username. But the functionality is similar. These are *your own files* and they cannot be seen/modified by other users (except admins).
:::

The primary purpose of this directory is to store small files, like github repositories and other code.

:::{warning}
Please do not store large files in your user directory `/home/jovyan`. Your home directory is intended only for notebooks, analysis scripts, and small datasets (< 1 GB). It is not an appropriate place to store large datasets.

Expand Down

0 comments on commit b71b0a0

Please sign in to comment.