# File Storage

### Overview

The Files module in MangoApps provides a secure document management system, allowing your company to organize, share, and sync work files across different devices. MangoApps integrates with three external storage solutions: Amazon Simple Storage Service (S3), Storage Area Network (SAN), and Box. You can configure the file storage for your domain via the Admin Portal, which will synchronize all MangoApps files and folders to the chosen repository in real-time.

<img src="/files/4JhFNtulsOguT9bL9C64" alt="Admin Portal > Modules > Files > File Storage" width="563">

**Amazon Simple Storage Service (S3):** Select the Amazon Simple Storage Service (S3) option to use your Amazon S3 account as the default file storage for your domain. This configuration will save all your MangoApps files to the specified Amazon S3 bucket. Once selected, all your domain files will be automatically uploaded to your Amazon S3 account.

**Storage Area Network (SAN):** Select the Storage Area Network (SAN) option to use your pre-configured SAN device as the default file storage for your domain. This setup saves all your MangoApps files to an external physical storage device. Once selected, all your domain files will be automatically uploaded to the configured SAN device.&#x20;

**Box:** Select the Box option to use your Box account as the default file storage for your domain. This configuration allows you to save all your MangoApps files directly to your Box account. Once selected, all files from your domain will be automatically uploaded to your Box account. To connect your Box account with MangoApps, click the **Configure Box Account** button.

{% hint style="info" %}
By default, MangoApps uses **Amazon S3** out-of-the-box as the storage repository to store all uploaded files in your domain.
{% endhint %}

***

### Configuring SAN Account

To configure a custom SAN account, click the **Configure Custom SAN Account** button for Storage Area Network (SAN):

<img src="/files/XQMgXiSY6vFkqV5wHrCT" alt="Configuring Custom SAN Account" width="563">

Enter the base location of your storage device in the SAN location text box. This is where all your files will be stored.

Click the **Test Connection** button to check the entered details and connect to the custom SAN account. The system displays a success message 'Connection to storage location successfully established.' on validating and successfully connecting to the SAN device.

Click the **Save and Activate** button to activate the custom SAN account as your default file storage for MangoApps.

{% hint style="info" %}
The SAN File Storage option is available only for the MangoApps **Private Cloud** and **On-Premise** deployment models. For more information on the deployment options for MangoApps, click [here](https://www.mangoapps.com/platform/deployment-options).
{% endhint %}

***

### Configuring Box Account

To connect your a Box account, click the **Configure Box Account** button for Box:

<img src="/files/igmTd6TlunEsmc72yea0" alt="Connecting Box Account" width="440">

This action prompts you to enter your Box account email address and password in the designated fields. Once filled, click the **Authorize** button to verify these details and allow MangoApps access to your Box account. This setup enables seamless file management, ensuring all MangoApps files are securely stored and managed within your Box account infrastructure.

{% hint style="info" %}
Box storage integration is currently **exclusive** to MangoApps private cloud customers.
{% endhint %}

***

### FAQs

#### What happens if I disable the Files module?

Disabling the Files module from the Admin Portal **(Admin Portal > Modules > Setup)** does not delete any files. It simply hides the module on the User Portal. When users attempt to access the Files module on the User Portal, MangoApps displays a warning message stating "This module is currently turned off by the Domain Administrator." However, users can still attach files to posts, pages, updates, chats, private messages, etc., on the User Portal. MangoApps automatically saves these files to the storage configured for your domain.

***

#### Is there a file size limit for document uploads?

The file upload limit varies across different interfaces (web, messenger, mobile portals) and depends on the storage option used (SAN or Amazon S3) in MangoApps. Here are the upload limits:

**SAN:**

* Maximum upload size per file from web portal: 2 GB
* Maximum upload size per file in chat and messenger: 2 GB
* Maximum upload size per file from file sync: 10 GB
* Maximum upload size per file from iOS and Android platforms: 200 MB
* Video files can be streamed online up to 1 GB without downloading.

**Amazon S3:**

* Maximum upload size per file from web portal: 5 GB
* Maximum upload size per file in chat and messenger: 2 GB
* Maximum upload size per file from file sync: 10 GB
* Maximum upload size per file from iOS and Android platforms: 200 MB
* Video files can be streamed online with no limit to file size.

For both SAN and Amazon S3 storage options across all platforms (web, messenger, mobile), there is no download limit to the file size. GIF content is limited to 4 MB per upload.

***

#### What are the visibility permissions for files & folders?

MangoApps has 4 visibility permissions for files and folders:

* **Private:** Setting the visibility of a file or folder as 'Private' removes everyone it’s been shared with and only the owner will have access to it.
* **Shared:** Setting the visibility of a file or folder as 'Shared' means only the users explicitly granted the permissions will have access to it.
* **Team**: Files/folders created in a project, group or department have visibility setting of 'Team'. This means that all members of the team by default have access to it.
* **Full Company:** Setting the visibility of a file or folder as 'Full Company' will allow everyone in your company access to it with Editor privileges.

{% hint style="info" %}

#### To see how these configurations impact the Files on the User Portal, see [Files](https://guides.mangoapps.com/user-guide/files) in the User Portal Guide.

{% endhint %}


---

# Agent Instructions: 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://guides.mangoapps.com/admin-guide/module-settings/files/file-storage.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.
