Working with files

Outcome You add files to your instance - by upload, Git clone, direct download, or external storage mount.

Before you start

• You hold at least the Instance Editor role in the target instance.

• You are in the Current state of the instance - files cannot be modified in a snapshot view.

• You know where your source data currently lives (local machine, Git repository, public URL, or external storage).

Files in Nuvolos live inside an Instance, accessible from the Files view in the sidebar and from inside any application running in that instance. The procedures below work the same way for any role - what differs is the typical use case (instructors uploading teaching materials, students working on assignments, researchers adding code and data).

Upload files via the web interface

The simplest path for individual files:

1

Navigate to the space and instance where you want the file.

2

On the sidebar, click the folder icon to open the Files view.

3

On the top left, click UPLOAD and choose your file.

The web UI uploads individual files. To upload a folder, compress it locally first (.zip or .tar.gz), upload the archive, then extract it from the ... Actions menu in the Files view. Supported archive formats include zip, tar, tar.gz, bz2, and tgz.

Clone a Git repository

Best when your code is already version-controlled. Open a terminal in any application and clone normally:

git clone <repository-url>

If the repository is private, generate an SSH key inside the application and add the public key to the repository's accepted keys. The Nuvolos-generated key persists in the Instance, so cloning continues to work for future sessions.

Download directly from the internet

Skip your local machine when the data is already at a public URL. From a terminal in any application:

wget <url>

You can also use curl, or any API call from a Python or R script that downloads to disk. The wget command is available in every Nuvolos application by default.

Mount external storage

If your data lives in cloud storage you already use, mount it as a folder in your instance rather than copying. Most well-known storage services are supported via rclone:

• Amazon S3

• Azure files

• Dropbox

• Google Drive

• Box

• SharePoint Online

Setup uses the rclone mount add-on. For specific guidance on the more common services, see the dedicated reference pages: Dropbox, S3 buckets, SSHFS, and SharePoint Online.

Larger datasets

For datasets that don't fit comfortably on the per-instance file system (typically above 100 GB), see Reference › File Storage for Large File Storage.