2.3.18 Satellite: JupyterLab

JupyterLab

Handle: jupyter URL: http://localhost:34101

An extensible environment for interactive and reproducible computing, based on the Jupyter Notebook and Architecture.

Starting

# [Optional] pre-build the image
harbor build jupyter

# Start the service
harbor up jupyter

# Open JupyterLab in the browser
harbor open jupyter

Configuration

Your notebooks are stored in the Harbor workspace, under the jupyter directory.

Harbor's shared model caches (Hugging Face, llama.cpp, vLLM, Ollama) are mounted into the container under /root. The Hugging Face cache is additionally mounted read-only at the same absolute path as on the host ($HOME/.cache/huggingface), so GGUFs in the llama.cpp cache that are symlinks to host HF-cache blobs resolve inside the container.

# Opens workspace folder in the File Manager
harbor jupyter workspace

# See workspace location,
# relative to $(harbor home)
harbor config get jupyter.workspace

Additionally, you can configure service to install additional packages.

# See deps help
# It's a manager for underlying array
harbor jupyter deps -h

# Add packages to install, supports the same
# specifier syntax as pip
harbor jupyter deps add numpy
harbor jupyter deps add SomeProject@git+https://git.repo/some_pkg.git@1.3.1
harbor jupyter deps add SomePackage[PDF,EPUB]==3.1.4

# Rebuilt the service image for dependencies
# to become available
harbor down
harbor build jupyter
harbor up jupyter

Apart from that, following options can be set via harbor config:

# The port on the host where JupyterLab will be available
HARBOR_JUPYTER_HOST_PORT       34101

# Image to use as a base for JupyterLab service
# Two requirements: have python and pip installed,
# can be any such image
HARBOR_JUPYTER_IMAGE           pytorch/pytorch:2.3.0-cuda12.1-cudnn8-runtime

# Location of the JupyterLab workspace on the host
# This is where service data is stored
# Should be either relative to $(harbor home) or an absolute path
HARBOR_JUPYTER_WORKSPACE       ./services/jupyter/workspace

# Extra dependencies to install in JupyterLab image
# semicolon-separated, will use pip to install them (so can use pip version specifiers)
HARBOR_JUPYTER_EXTRA_DEPS