> For the complete documentation index, see [llms.txt](https://docs.vergeos-demo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vergeos-demo.com/run-the-platform/storage/uploading-files-to-vsan.md).

# Uploading Files to the vSAN

The *Files* section provides for uploading files to the VergeOS vSAN, allowing \*.iso files, drive images, VM definition files, etc. to be easily accessible for creating/installing/importing VMs.

{% hint style="info" %}
Optionally, files that are uploaded to the *Files* section can be shared via a public link.
{% endhint %}

## Upload a File from the Local Computer

1. Select **Files** from the top menu.
2. Select **Upload**.
3. Click the **Choose Files** button
4. The File Browser Dialog appears. Browse to the desired folder and select the desired file(s). Holding down the ctrl or shift key allows for multi-selection.
5. Click the **Open** button
   * Selected Files, along with size and type are displayed.
6. Click the **Upload** button.
7. An Upload Progress popup window will appear showing the upload progress. From this window, the upload can be canceled or paused, if needed. When the upload operation is complete, the file(s) will display in green in the Upload Progress popup.

{% hint style="warning" %}
Reloading the browser window will interfere with the file upload.
{% endhint %}

## Upload a File from a Web Link (URL)

1. Select **Files** from the top menu.
2. Select **Upload from URL**
3. Enter a valid URL (for example: `https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.iso`)
4. Enter desired **Name** for the file.
5. Optionally, a **File Description** can be entered to provide additional information.
6. Select a **Preferred Tier** or leave the setting at Default.
7. The **Allow insecure SSL links to be used** option will permit the file download from a site without a valid CA-signed certificate (e.g. missing, invalid, expired, or self-signed certs).
8. The **Skip header check** option bypasses standard header security validation policies which may improve upload time but may potentially increase data integrity and security risk. Use with caution.
9. Click the **Submit** button
10. The file will appear in the *Files* listing.

## Create a Download Link for an uploaded File

1. Select **Files** from the top menu.
2. Select the desired **File** from the list.
3. Click **Add Public Link** on the left menu.
4. Select a **Link Format**
   * **Anonymous(uuid)** - creates a public download link using a GUID(128-bit number) *ex: `https://verge.example.com/273b5d6a--b205-1e1b-6ae6-01cfa7ed1233`*
   * **Custom** - creates a public download link using the name entered *ex: `https://verge.example.com/customname`*
   * **Use File Name (recommended)** - creates a public download link using the original filename *ex: `https://verge.example.com/virtio-win-1.9.6.iso`*
5. Select **Expiration Type**
   * **Never Expire (default)** to make the download link perpetual. (Public Link can be manually edited or deleted later if needed.)
   * **Set Date** to select a specific date/time to cease the download link.
6. Click **Submit** to save the link.

![Media Images Link Copy](/files/BO0IuuNyPcDPm4x2H4br)

The Files list appears. Download options appear on the far right of the given file:

* Click **Link** to directly download the file from the page.
* Click the **copy icon** to copy the download address to the clipboard.


---

# 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:

```
GET https://docs.vergeos-demo.com/run-the-platform/storage/uploading-files-to-vsan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.