> 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/knowledge-base/virtual-machines/managing-files.md).

# Managing Files

The **Files** section provides a central location to upload files for use in VergeOS. It supports ISOs, VM disk images, logos for custom branding, and general file sharing between sites and tenants.

## How to Upload Files to VergeOS

To upload a file, ensure that it is in one of the supported formats.

{% hint style="info" %}
**Other extensions can be uploaded to the server but may not be recognized as usable by VergeOS.**
{% endhint %}

1. Select **Files** from the top menu and click **Upload**.
2. You may also choose **Upload from URL** if you are sharing a file from another site or have a URL.

Once the file transfer completes, it will be available in the **Files** list for use.

## Creating a Public Link

1. To create a **Public Link**, select a file and click **Add Public Link** from the left menu.
2. Choose the format for sharing the file:

### Link Format

* **Anonymous (uuid)**: Appends the file's UUID to the end of the link.
* **Custom**: Allows for a custom name to be used in the link.
* **Use file name**: Appends the existing file name and extension to the link.

### Expiration Type

* **Never Expire**: The link will remain active indefinitely.
* **Set Date**: Set a specific expiration date and time for the link.

The **Public Link** can be shared with other systems, for general file sharing, or with local tenants to provide access without requiring an internet download. However, sharing via this method uses network bandwidth. For a more efficient way to share files to a tenant, see the [Sharing Files to Tenants](/knowledge-base/tenants/sharing-files-to-tenants.md) guide.

{% hint style="info" %}
**In the Files section, you can also:**

* Manipulate **Public Links**
* **Download** files
* **Edit** file names and storage tiers
* **View and Remove References** to files
* **Delete** files."
  {% endhint %}

***

{% hint style="info" %}
**Document Information**

* Last Updated: 2024-08-29
* vergeOS Version: 4.12.6
  {% endhint %}


---

# 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/knowledge-base/virtual-machines/managing-files.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.