File system and storage

Choose your context

In all of the following operations, we assume that you know how to pick the appropriate context for your work (that is, finding the current state of an instance in which you are implicitly or explicitly an editor).
Only current states can be modified - snapshots are immutable!
As an example:
Finding files in a specific instance

Create a folder

After navigating to the files view of the instance you are working in:
Creating a folder

Upload files

You can upload files and folders to Nuvolos with the upload button.
Uploading an entire folder with contents using drag and drop
You can choose to upload files from your local device, or from a publicly accessible web address. The latter is recommended for uploading large amounts of data to Nuvolos, as it is handled by a background process and once started, you may even close your browser without interrupting the upload process.
Upload from Web Address currently only support publicly available URLs, without any form of authentication.
Certain servers respond with a "Not found" page, but no error code when trying to access a non-existent asset on them. In such cases, the "Not found" page will be uploaded to Nuvolos.
In case you cannot upload a file from your local device due to it being extremely large, you can either upload it via a Web Address (if possible) or try uploading it via JupyterLab:
  1. 2.
    Use the upload feature in JupyterLab:
Uploading large files

Download files

You can download a file by selecting it and finding the download button:
Downloading a file

Delete files

You can delete one or more files by selecting them and then finding the delete button.
Deleting a folder

Move files

You can move files around in the directory structure using the following flow:

Copy files

You can copy a file to a different folder using the following steps:
Select the file to copy and move to the desired location

Rename files

You can rename a file by selecting it and finding the rename button:
Renaming a file

The diff feature

It is possible to view the difference of two text files in two different snapshots. In this example, we assume that there was a snapshot taken in the instance.
  • An orange dot next to a filename means that the file has not been snapshot yet.
  • A blue dot next to a filename means that the file has been snapshot and has been changed since the last snapshot taken.
  • A green dot next to a filename means that the file has been snapshot and has not been changed since the last snapshot taken.
Hovering over the dot pops up the diff menu:
The diff feature and snapshotting provide a powerful tool

The readme feature

If you create a file named in a folder, the user interface of Nuvolos will try to interpret and render it as a markdown file. The created in the root directory will also be displayed on the space overview page.
As an example:
You can do this in every folder if you want to - this is a great way to document contents of folders beyond the usual filename information you can provide yourself!