Files

The Files page is your workspace filesystem: the same tree a runtime mounts at /home/user/workspace. Anything you upload here is there when a runtime starts, and anything a notebook writes to the workspace shows up here when the runtime stops.

Browsing

  • Folders open on click; the breadcrumb at the top walks back up. Each workspace has its own tree, and the switcher in the sidebar changes workspaces.
  • Search this folder filters the current folder on the server, so it works on folders too large to list at once.
  • Show hidden files toggles dot-files. Two top-level directories are managed by the platform and never listed: .ns-uploads (upload staging) and .ns-cache (the package cache). Nested directories of the same name are ordinary.

Adding files

  • New Notebook creates an empty .ipynb in the current folder and opens it. New Folder creates a folder.
  • Upload opens Upload Files: choose files, or drag and drop them onto the dialog. Several files can be uploaded at once; folders cannot be uploaded as a whole, so create the folder first and upload into it. A single file may be up to 5 TiB, which in practice means the limit is your storage pool.
  • Import from cloud… and Export to… start a transfer to or from a storage connection; see Storage connections and transfers.
  • Everything you add is checked against the free space in your pool before a byte is written. When the pool is full, every workspace that shares it refuses new writes until something is deleted.

Working with a file

Each row has a menu:

  • Open. Notebooks open in the notebook editor. Other files are not previewed in the browser; download them or read them from a runtime.
  • Download (files only; folders cannot be downloaded as a whole).
  • Share gives one person view and copy access, or creates a public link; see Sharing. Folders cannot be shared.
  • Rename (files only; folders cannot be renamed).
  • Delete removes a file immediately. There is no trash. A folder can only be deleted once it is empty.

Move a file or folder by dragging it onto a folder, or onto a breadcrumb to move it up the tree. A move is refused when a file of the same name already exists at the destination.

Viewers see the read-only actions only. Editors and owners see everything.

Your storage pool

The bar on the Files page shows the account's storage pool and how much of it this workspace holds. The pool is per account and shared by every workspace you own; a workspace somebody else owns draws on their pool, and the page says so. Everything under the workspace counts, including .ns-cache, which holds the packages you pip install in a runtime.

Large datasets, model downloads and other re-creatable data belong on the runtime's local scratch disk, which does not count; see Large datasets and models. Data bigger than your pool is best read straight from your own bucket.

Notebooks are plain files

A notebook on the Files page is a standard .ipynb. Download it and it opens in Jupyter, Colab, Kaggle or VS Code with nothing lost but the runtime it ran on. Commits made from a runtime strip outputs by default; see Git in your runtime.