---
title: "Running Jupyter Notebooks in your LUSID domain"
slug: "running-jupyter-notebooks-in-your-lusid-domain"
updated: 2024-12-17T13:16:58Z
published: 2024-12-17T13:16:58Z
canonical: "support.lusid.com/running-jupyter-notebooks-in-your-lusid-domain"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.lusid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Running Jupyter Notebooks in your LUSID domain

[Jupyter Notebooks](https://jupyter.org/) are a blend of live code and documentation.

We've integrated a [Jupyterhub](https://jupyter.org/hub) instance into your LUSID domain. This means:

- You can run the [sample Notebooks provided by FINBOURNE](https://github.com/finbourne/finbourne-notebooks) and stored in Github from within LUSID and see the results of exercising the LUSID SDK impact the data in your domain. The process of authenticating to the LUSID SDK is handled by LUSID's identity provider, Okta, and is thus greatly simplified in comparison to running the sample Notebooks locally by pulling the Github repo.
- You can create, store and run your own Notebooks.

## Accessing Jupyterhub

1. Navigate to `<your-domain>.lusid.com/app` and sign in to your LUSID web app.
2. From the **Additional tools** menu on the left-hand side, select **Jupyter Notebooks**: ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/f7755761-1ff4-4d49-84b2-bc18d73cb8f3.png)
3. Click the **Sign in with Okta** button: ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/1de426f1-01b5-461c-bc9f-428971cc9a44.png)
4. Sign in to LUSID again and open the `sample notebooks` folder to list the sample Notebooks [as they appear in Github](https://github.com/finbourne/finbourne-notebooks): ![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/3180d926-291e-49bd-b982-faf6ab7c8637.png)

Note most of the useful demonstrations are in the `examples` subfolder. To open and examine a Notebook, click a file with an `.ipynb` extension.

To execute a Notebook (that is, run all the live code and impact the data in your LUSID domain), choose **Kernel > Restart & Run All**:

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/1d8c9cda-6d26-40cf-9c14-b9d55fc7eb3f.png)

## Uploading your own Notebooks

You can select the **Upload** button to store your own Notebooks.

Please do not store *critical* files in your Juypterhub instance. To optimise performance, we periodically refresh Jupyterhub which means non-core files will be deleted.

![](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/bf2c4563-87a3-4d2e-8292-cf21107092f3.png)