# Including some example notebooks in Pangeo cluster

**URL:** <https://discourse.pangeo.io/t/including-some-example-notebooks-in-pangeo-cluster/422>\
**Category:** Cloud\
**Created:** [December 13, 2019, 12:46am UTC](https://discourse.pangeo.io/t/including-some-example-notebooks-in-pangeo-cluster/422 "2019-12-13T00:46:22Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![JoeCorbett](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/joecorbett/32/243_2.png) [@JoeCorbett](https://discourse.pangeo.io/u/JoeCorbett)\
**Post date:** [December 13, 2019, 12:46am UTC](https://discourse.pangeo.io/t/including-some-example-notebooks-in-pangeo-cluster/422/1 "2019-12-13T00:46:22Z")

</div>

Hello,

I have been playing around with a Pangeo deployment on GCS. I am super impressed with how easy it was to setup and get using with the instructions provided on [Pangeo.io](http://Pangeo.io). I have found the cluster easy to use and very helpful.

I’m going to share access with my colleagues but I want to include some example notebooks for them to run. Is it possible to include example notebooks in a deployment? And what is the best way to do it?

I have tried building my own image following the instructions here [https://github.com/pangeo-data/pangeo-stacks#customize-images-with-the--onbuild-variants](https://github.com/pangeo-data/pangeo-stacks#customize-images-with-the--onbuild-variants)

I built the image locally using `docker build` in a repo with the notebooks I wanted to include, pushed it to our google container registry and then updated the docker image in the helm charts. JupyterHub loads with the correct image, but the notebooks aren’t in there.

Any suggestions?

Thanks!

Joe

---

<div class="post-metadata">

**Author:** ![rabernat](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/rabernat/32/22_2.png) [@rabernat](https://discourse.pangeo.io/u/rabernat)\
**Post date:** [December 13, 2019, 3:32am UTC](https://discourse.pangeo.io/t/including-some-example-notebooks-in-pangeo-cluster/422/2 "2019-12-13T03:32:23Z")

</div>

Good point Joe!

We used to provide pre-loaded examples on some jupyterhubs but have since stopped doing so. Our recommended practice is for users to use git to bring in example content, for example

```auto
git clone https://github.com/pangeo-data/pangeo-ocean-examples.git

```

bring in one of our main demo repos.

> **[pangeo-data/pangeo-ocean-examples](https://github.com/pangeo-data/pangeo-ocean-examples)**
>
> Examples of analysis of ocean data and simulation outputs using xarray, xgcm, and pangeo. - pangeo-data/pangeo-ocean-examples

In the pangeo-verse, we like to assume everyone is comfortable using git from the command line.  
But we can make this even easier by using [nbgitpuller](https://github.com/jupyterhub/nbgitpuller) to create a button or link that automatically does this without touching the command line. Like this one I use for my [Earth and Environmental Data Science](https://earth-env-data-science.github.io/) class.

[![badge](https://img.shields.io/badge/open-ocean.pangeo.io-lightgrey?logo=jupyter&style=flat-square&color=5eb130)](https://ocean.pangeo.io/hub/user-redirect/git-pull?repo=https://github.com//earth-env-data-science/earth-env-data-science-book&branch=master&subPath=content%2Flectures%2Fxarray%2Fxarray.ipynb&app=lab)

This is what we commonly do for classes, workshops, and tutorials.

---

<div class="post-metadata">

**Author:** ![JoeCorbett](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/joecorbett/32/243_2.png) [@JoeCorbett](https://discourse.pangeo.io/u/JoeCorbett)\
**Post date:** [December 13, 2019, 4:53am UTC](https://discourse.pangeo.io/t/including-some-example-notebooks-in-pangeo-cluster/422/3 "2019-12-13T04:53:40Z")

</div>

Nice! Thanks @rabernat - great solution that save me from messing around with persistent volumes in Kubernetes.

---

<div class="post-metadata">

**Author:** ![rabernat](https://yyz2.discourse-cdn.com/flex030/user_avatar/discourse.pangeo.io/rabernat/32/22_2.png) [@rabernat](https://discourse.pangeo.io/u/rabernat)\
**Post date:** [December 13, 2019, 5:25am UTC](https://discourse.pangeo.io/t/including-some-example-notebooks-in-pangeo-cluster/422/4 "2019-12-13T05:25:17Z")

</div>

To be clear, if you did want to add content to the home directory, it’s not difficult either. You would just edit the repo2docker-based image used to build the user’s jupyter server environment. An example configuration is here:

> **[pangeo-data/pangeo-cloud-federation](https://github.com/pangeo-data/pangeo-cloud-federation/tree/staging/deployments/ocean/image)**
>
> Deployment automation for Pangeo JupyterHubs on AWS, Google, and Azure - pangeo-data/pangeo-cloud-federation

But in general we try to keep these as simple and small as possible.