> For the complete documentation index, see [llms.txt](https://igb.mit.edu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://igb.mit.edu/mini-courses/research-computing-on-engaging-with-vscode/connecting-to-engaging-via-ondemand/interactive-apps/jupyter-notebook.md).

# Jupyter Notebook

The Jupyter Notebook option allows you to run Jupyter Notebook on the cluster's compute nodes. Before starting Jupyter Notebook, you must configure the resource usage in the form below.

<figure><img src="https://498238201-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWuHhstIreJ3jFvE4gQ3y%2Fuploads%2FnW587rZlnTyGLY558L6W%2FScreenshot%202026-09-16%20at%201.27.55%E2%80%AFPM.png?alt=media&amp;token=c820a171-faa7-4d9c-bf9e-39d584385782" alt=""><figcaption></figcaption></figure>

After filling out the form with the appropriate information, hit launch to queue launching Jupyter Notebook on the Engaging compute nodes.&#x20;

While the job is in the queue, you'll see the following page, which contains basic information about the application you've launched, and will allow you to delete it from the queue.

<figure><img src="https://498238201-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWuHhstIreJ3jFvE4gQ3y%2Fuploads%2FBzHmFhpH9fijQCPoPWro%2FScreenshot%202026-09-16%20at%201.29.04%E2%80%AFPM.png?alt=media&amp;token=0f5debf6-7393-410b-9a6a-8df137df68de" alt=""><figcaption></figcaption></figure>

Once the application has been launched, the page will update to include some basic settings and the "Connect to Jupyter" button. Pressing that will open Jupyter Notebook in a new browser tab.

<figure><img src="https://498238201-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWuHhstIreJ3jFvE4gQ3y%2Fuploads%2FNlrXeWujPPCKbSzYz2h2%2FScreenshot%202026-09-16%20at%201.29.16%E2%80%AFPM.png?alt=media&amp;token=41fcb133-a7de-4e70-8356-db2cffb67ca6" alt=""><figcaption></figcaption></figure>

Now, you can use Jupyter Notebook as normal. You can navigate to an existing Jupyter Notebook file on Engaging, create a new empty one, or upload one you have locally.

<figure><img src="https://498238201-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWuHhstIreJ3jFvE4gQ3y%2Fuploads%2FJVh3hH6ojXQ8B3sJJir2%2FScreenshot%202026-09-16%20at%201.35.35%E2%80%AFPM.png?alt=media&amp;token=69d18776-2e44-4561-8d20-c90114b4c40a" alt=""><figcaption></figcaption></figure>

### Using Jupyter Notebook with custom Conda environments

If you have an existing Conda environment that you'd like to use in a Jupyter Notebook, you can make it available by installing Jupyter into your Conda environment and then registering that environment.

```bash
module load miniforge
conda activate MY_ENV
conda install jupyterlab
python -m ipykernel install --user --name $CONDA_DEFAULT_ENV
```

After you've run these set of commands, your environment will be listed when you open a new tab in Jupyter. For example, I've registered a Conda environment named `dreg` , and it is available in the list below:

<figure><img src="https://498238201-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWuHhstIreJ3jFvE4gQ3y%2Fuploads%2FYk2eKaZXJWpjcRfJGuR9%2FScreenshot%202026-09-17%20at%203.27.33%E2%80%AFPM.png?alt=media&amp;token=1e0138b6-2ac2-4d54-800f-f808e056e03d" alt=""><figcaption></figcaption></figure>
