Skip to main content

Loading screen: bootstrap process

When accessing a Notebook link, you land on a loading page, this is called the bootstrap phase.

During that phase, the following steps will occur:

  1. Retrieve the project/repository content
  2. Locate the environment definition and/or its lock file
  3. Check for a cached environment:
  • If found, redirect to the JupyterLite page
  • If not found, proceed to environment resolution
  1. Resolve the environment (if no lock file is provided)
  2. Upon successful resolution, redirect to the JupyterLite UI with your environment ready for use
warning

If the resolution of the environment fails, you will see solver issues, helping you to debug your environment definition. See the Environment creation documentation for guidance on how to make an environment that is compatible with Notebook.link.

Loading-screen

The loading screen contains a log window, helping you see what happens during the bootstrap phase. You can view the detailed log by clicking the Show button.

Loading-screen-with-error

note

If an error occurs during bootstrapping, you have two options:

  1. Continue:

    • Proceed with the default environment (contains only a Python kernel)
    • Useful when you lack permissions to modify the repository's environment.yml file
    • You can still install required packages by dynamically installing new packages

  2. Retry:

    • Reset your browser cache and restart the bootstrap process
    • Helpful when invalid cached data prevents successful bootstrapping