> For the complete documentation index, see [llms.txt](https://docs.nuvolos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nuvolos.com/reference/file-system-and-storage/file-navigator.md).

# File navigator

When working on Nuvolos, you typically interact with files inside a running Application. However, common file manipulation tasks can also be carried out directly via the web UI through the file navigator.

#### Open the file navigator

1. Navigate to the Space and Instance.
2. Make sure you are in the **Current state**.
3. On the sidebar, click the folder icon (**Files**).

The starting screen always shows the root folder of the **Workspace** area, mounted at `/files` in Applications. Use the dropdown below the **Upload** button to switch between Workspace and Personal files.

### Upload files

Upload files from your local computer or from a publicly available web URL using the UPLOAD button on the top right. If a name conflict occurs, the new filename is renamed with a (1), (2), ... postfix.

### Create files or folders

Create folders and simple text files using the + NEW button next to UPLOAD. Name conflicts are resolved the same way as uploads.

### Download files

You have multiple options to download files from Nuvolos to your local machine:

* **Single file**: click ... in the **Actions** column and choose **DOWNLOAD**.
* **Single folder**: same path; the folder is delivered as a ZIP archive.
* **Up to 10 selected items**: select items via the tickboxes, then click **DOWNLOAD SELECTED** in the top menu.
* **All in current folder**: click **DOWNLOAD ALL** in the top menu.

### Move, copy, rename, delete

All available from the ... Actions menu in the file row.

### Extract (unzip) archives

Extract (unzip) archives from the ... Actions menu. Supported formats:

```
.zip, .gz, .tar, .tgz, .tar.gz, .bz2
```

During extraction, a folder with the same name as the archive is created automatically. If a file or folder with that name exists, a new name is generated.&#x20;

{% hint style="info" %}
Extraction runs in the background - check the Tasks view to confirm completion.
{% endhint %}

The Web UI also supports manipulating the contents of certain files, which is described in the section [Preview files](/reference/file-system-and-storage/preview-files.md).

### Limitations

Soft links are not displayed in the web UI's file navigator, but they still work in your Nuvolos Applications.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nuvolos.com/reference/file-system-and-storage/file-navigator.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
