Share data with your users

There are a few options for sharing data with your users, this page covers a few useful patterns.

Option 1: Distributing data with nbgitpuller

For small datasets, the simplest way to share data with your users is via nbgitpuller links. In this case, users click on your link and the dataset contained in the link’s target repository is downloaded to the user’s home directory. Note that a copy of the dataset will be made for each user.

For information on creating and sharing nbgitpuller links, see Distributing materials to users with nbgitpuller.

Option 2: Create a read-only shared folder for data

If your data is large or you don’t want copies of it to exist, you can create a read-only shared folder that users have access to. To do this, follow these steps:

  1. Log in to your JupyterHub as an administrator user.

  2. Create a terminal session with your JupyterHub interface.

    New terminal button.
  3. Create a folder where your data will live. We recommend placing shared data in /srv. The following command creates two folders (/srv/data and /srv/data/my_shared_data_folder).

    sudo mkdir -p /srv/data/my_shared_data_folder
    
  4. Download the data into this folder. See Adding data to the JupyterHub for details on how to do this.

  5. All users now have read access to the data in this folder.