Work with files

Outcome You upload, download, organise, and edit files in your personal Instance.

Before you start

• You are inside your course Instance.

• You are in the Current state (the live, writable version of the Instance).

Two ways to work with files

You can manage files from two places:

• The Nuvolos web UI (Files view) - best for quick uploads, downloads, renames, and previews. Reach it via the folder icon on the sidebar.

• Inside a running Application - best when you are already coding. Files in /files (Workspace) and ~ (Personal) are persistent; changes save automatically.

Most common file operations

• Upload a file from your computer - click UPLOAD in the Files view.

• Download a file - click the ... Actions menu on the file row and choose DOWNLOAD.

• Download a folder - same menu; the folder is delivered as a ZIP archive.

• Extract an archive (zip, tar.gz, bz2, and similar) - use the ... Actions menu and choose EXTRACT.

• Edit a small text file in the browser - click the file name and choose Edit. Supported for files under 1 MB that decode to UTF-8.

For the full file navigator reference, including all supported archive formats and the file preview behavior, see Reference › Storage and file access.

Navigate personal and Workspace areas

Outcome You understand the difference between Workspace, Personal, and Application library areas, and you know which one to put a file in.

Before you start

• You have at least one application running, or the Files view open.

Each Nuvolos application has three persistent storage areas. They look identical inside the application, but they have different visibility scopes and different use cases.

Area	Where it lives	Who can see it	What it's for
Workspace files	/files in the Application	All users in your Instance	Course materials, your assignments, files you want collaborators to see.
Personal files	~ (your home directory)	Only you, only in this Instance	Personal scratch files, account-specific configuration, files you do not want to share.
Application library files	Depends on Application type	All users for the same Application in this Instance	Packages and libraries you install in the Application.

In the Nuvolos web UI Files view, you can switch between Workspace and Personal using the dropdown below the UPLOAD button. Application library files are managed automatically by the Application itself.

When you submit an assignment, only files in the Workspace (/files) are included. Keep your assignment files in Workspace, and use Personal for scratch work that should not be submitted.