Local File System Usage#

At the current time, there are several file systems at play in JupyterLite, and even more so if a local file system is mounted.

  • JupyterLite file system;

  • browser storage file system;

  • local file system.

When opening notebook files from the JupyterLite file system, a copy of the files appears in local browser storage; when opening from the desktop filesystem, no copy appears in local browser storage.

If you open a data file from the JupyterLite file system and then save it, it also appears in local browser storage; it can then be opened programmatically from local browser storage.

You can’t seem to open a data file from the local filesystem and save it into browser storage.

Irrespective of whether the jupyterlab-filesystem-access extension is installed, you can manually upload a data file from the desktop file system into the JupyterLite file system (this seems to have a side effect of also placing the file immediately into browser storage).

When working with a local file system, if a new notebook is created in the JupyterLite environment, it will not be saved to the local file system: it forms part of the JupyterLite file system, and when saved will be saved to browser storage. To get the file into the local file system, you need to download it (File > Download). Note that the downloaded file is the saved version of the file, so save your notebook before downloading it. Close the notebook in JupyterLite, and then ensure that the downloaded copy is placed into the appropriate local file system directory. Reopen the notebook from the local file system file listing in JupyterLite. Any updates made to the notebook and then saved will now also be saved back to the local file system.

The directory path the upload file file picker opens at may be different to the directory path used in selecting the directory on the desktop filesystem.