Comment on page
File system and storage
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
Each Nuvolos subscription has a storage allowance on the Nuvolos filesystem that you are free to consume in an many spaces as you wish. However, to control situations with runaway storage allocation, each Nuvolos instance has a hard limit (quota) on how much data it is able to store. You can ask support to set up a custom quota for your space(s), the only requirement is that your total combined storage usage should be in line with your subscription.
You can easily check the quota and your storage consumption in any instance. After navigating to the files view of the instance you are working in, look for the quota badge at the top right of the screen:
The badge shows the limit (quota) and the percentage used in this particular instance
You can click on the quota badge to bring up a detailed breakdown of your filesystem usage:
Detailed breakdown of filesystem usage
- Workspace files are the same for all users and applications in the space, so it cannot be broken down into smaller units.
- Personal files are displayed per user in the instance (this is the total size of Linux home folders per user in this instance)
- Application files are displayed per application (this is the total size of application libraries per application).
After navigating to the files view of the instance you are working in:
Creating a folder
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:
Uploading large files
You can download a file by selecting it and finding the download button:
Downloading a file
You can delete one or more files by selecting them and then finding the delete button.
Deleting a folder
You can move files around in the directory structure using the following flow:
You can copy a file to a different folder using the following steps:
Select the file to copy and move to the desired location
You can rename a file by selecting it and finding the rename button:
Renaming a file
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
If you create a file named
README.mdin a folder, the user interface of Nuvolos will try to interpret and render it as a markdown file. The
README.mdcreated 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!