# JupyterLab

Bench workspaces require setting a Docker image to use as the image for the workspace. Illumina Connected Analytics (ICA) provides a default Docker image with [JupyterLab](https://jupyterlab.readthedocs.io/en/stable/) installed.

JupyterLab supports [Jupyter Notebook documents](https://ipython.org/ipython-doc/dev/notebook/notebook.html#notebook-documents) (.ipynb). Notebook documents consist of a sequence of cells which may contain executable code, markdown, headers, and raw text.

The JupyterLab Docker image contains the following environment variables:

<table><thead><tr><th width="321.58984375">Variable</th><th>Set to</th></tr></thead><tbody><tr><td>ICA_URL</td><td><code>https://ica.illumina.com/ica</code> (ICA server URL)</td></tr><tr><td><del><em>ICA_PROJECT</em></del><em> (Obsolete)</em></td><td>ICA project ID</td></tr><tr><td>ICA_PROJECT_UUID</td><td>Current ICA project UUID</td></tr><tr><td>ICA_SNOWFLAKE_ACCOUNT</td><td>ICA Snowflake (Base) Account ID</td></tr><tr><td>ICA_SNOWFLAKE_DATABASE</td><td>ICA Snowflake (Base) Database ID</td></tr><tr><td>ICA_PROJECT_TENANT_NAME</td><td>Name of the owning tenant of the project where the workspace is created.</td></tr><tr><td>ICA_STARTING_USER_TENANT_NAME</td><td>Name of the tenant of the user which last started the workspace.</td></tr><tr><td>ICA_COHORTS_URL</td><td>URL of the Cohorts web application used to support the Cohort's view</td></tr></tbody></table>

{% hint style="info" %}
To export data from your workspace to your local machine, it is best practice to move the data in your workspace to the `/data/project/` folder so that it becomes available in your project under **projects > your\_project > Data**.
{% endhint %}

## ICA Python Library

Included in the default JupyterLab Docker image is a python library with APIs to perform actions in ICA, such as add data, launch pipelines, and operate on Base tables. The python library is generated from the [ICA Open API specification](https://ica.illumina.com/ica/api/swagger/index.html#/) using [openapi-generator](https://github.com/OpenAPITools/openapi-generator).

The ICA Python library API documentation can be found in folder `/etc/ica/data/ica_v2_api_docs` within the JupyterLab Docker image.

See the [Bench ICA Python Library Tutorial](https://help.ica.illumina.com/tutorials/bench-ica-python-library) for examples on using the ICA Python library.