---
title: How to connect MASV with a QNAP storage device
description: Simplify transfers to and from your QNAP NAS with MASV
---

[Skip to content](https://help.massive.io/en/how-to-connect-masv-with-a-qnap-storage-device#main-content)

[![MASV logo](https://help.massive.io/hs-fs/hubfs/MASV_Logo_Colour_2026.png?width=150&height=38&name=MASV_Logo_Colour_2026.png)](https://massive.io/)

- [Home](https://help.massive.io/en)
- [Products](https://massive.io/product/)
- [Pricing](https://massive.io/pricing/)
- [Blog](https://massive.io/blog/)
- [Company](https://massive.io/about-us/)

Open main navigation

Close main navigation

- [Home](https://help.massive.io/en)
- [Products](https://massive.io/product/)
- [Pricing](https://massive.io/pricing/)
- [Blog](https://massive.io/blog/)
- [Company](https://massive.io/about-us/)

 How can we help?

- There are no suggestions because the search field is empty.

1. [Help Center - MASV](https://help.massive.io/en?hsLang=en)
2. [Apps & Integrations](https://help.massive.io/en/apps-integrations?hsLang=en)
3. [On-premises and cloud storage devices](https://help.massive.io/en/apps-integrations?hsLang=en#on-premises-and-cloud-storage-devices)

# How to connect MASV with a QNAP storage device

## Simplify transfers to and from your QNAP NAS with MASV

MASV makes it easy for you and your collaborators to ingest large files into your QNAP storage. You can also use MASV to send files from your QNAP storage.

This page includes the following topics:

- [Overview](https://help.massive.io/en/how-to-connect-masv-with-a-qnap-storage-device#overview)
- [Prepare file structure in File Station](https://help.massive.io/en/how-to-connect-masv-with-a-qnap-storage-device#file-structure)
- [Create a MASV Engine container in Container Station](https://help.massive.io/en/how-to-connect-masv-with-a-qnap-storage-device#create-container)
- [Create secure connection between MASV and QNAP NAS](https://help.massive.io/en/how-to-connect-masv-with-a-qnap-storage-device#connect)
- [Save files to your QNAP NAS with MASV portals](https://help.massive.io/en/how-to-connect-masv-with-a-qnap-storage-device#portals)

### Overview

When you connect MASV to your QNAP device, you use a container to install the MASV Engine (formerly MASV Agent). What's a container? Most QNAP users will be familiar with the QNAP Container Station. Containers are self-contained environments where you can run lightweight applications, such as MASV Engine. Docker is the platform used to package the applications and set up the environment within the container, providing a predictable and consistent way to install, run, update, and manage an application without affecting a device's main operating system. Containers have a similar function to virtual machines, but containers are lighter and more efficient.

The basic workflow for setting up MASV with your QNAP NAS include the following:

1. Preparing a file structure on your QNAP NAS by using File Station.
2. Install the Docker version of the MASV Engine with the QNAP **Container Station** app by pulling the MASV Engine image and creating a container. install the Docker version of the MASV Engine on your QNAP NAS via the .
3. Create a secure connection to a QNAP destination (directory you want to read or write to) in the MASV Admin Console (formerly MASV Web App).
4. Use[MASV Portals](https://help.massive.io/en/how-to-create-a-portal-in-masv?hsLang=en) to ingest files from contributors or send files to your QNAP storage.

**MASV Engine installation**: For full MASV Engine installation instructions, including information about specific user and group settings, please visit [MASV Engine setup with Docker](https://developer.masv.io/agent/install-docker/) . For the default installation, visit the tutorial page listed below.

### Prepare a file structure with File Station

#### To prepare a file structure in File Station

1. In the QNAP QTS software, select **File Station**.![qnap-file-station-icon](https://help.massive.io/hs-fs/hubfs/KB/qnap-file-station-icon.png?width=109&height=129&name=qnap-file-station-icon.png)
2. In **File Station**, create the folder structure you want to use or verify that you have an existing folder structure that you can use.![qnap-file-station-structure](https://help.massive.io/hs-fs/hubfs/KB/qnap-file-station-structure.webp?width=180&height=121&name=qnap-file-station-structure.webp)

### Create MASV Engine container in Container Station

You can use **Container Station** to install the **MASV Engine**. If you don't have **Container Station** installed, you can install it from the **App Center** available on the QNAP QTS and QuTSCloud platforms.

#### To install QNAP Container Station

1. In QNAP QTS or QuTSCloud, open the **App Center.**
2. Search for **Container Station**, and select **Install**. The app installs in the background.
3. When the Welcome screen appears, accept the default image location or set a custom location and select **Start**.

#### To create a MASV Engine container with Container Station

1. In your QNAP QTS software, open **Container Station**.![qnap-container-station-icon](https://help.massive.io/hs-fs/hubfs/KB/qnap-container-station-icon.webp?width=133&height=136&name=qnap-container-station-icon.webp)
2. In the **Container Manager**, select **Container** from the sidebar on the left, and select the **Create** button.![qnap-container-station-create-container](https://help.massive.io/hs-fs/hubfs/KB/qnap-container-station-create-container.webp?width=670&height=378&name=qnap-container-station-create-container.webp)
3. In the **Create Container** window, on the **Select Image** page, choose the following:
   
     - **Mode**: Select **Basic** mode.
     - **Registry**: Select **Docker Hub**.
     - **Image**: Copy and paste the following image reference: **masvio/masv-engine:**\[version number\].
     - Select the **Try pulling the image from the registry before creating the container** checkbox.![qnap-create-container-window](https://help.massive.io/hs-fs/hubfs/KB/qnap-create-container-window.png?width=670&height=466&name=qnap-create-container-window.png)
4. Select **Next**.
5. On the **Configure Container** page, type a name for the container, and we recommend setting the **Restart policy** to **Always**. Review the **Network Configuration** settings and make changes to the default if you need to.![qnap-configure-container](https://help.massive.io/hs-fs/hubfs/KB/qnap-configure-container.png?width=670&height=475&name=qnap-configure-container.png)
6. Select the **Advanced Settings** link, and in the **Advanced Settings** window, select **Storage** from the sidebar.![qnap-map-container-storage](https://help.massive.io/hs-fs/hubfs/KB/qnap-map-container-storage.png?width=670&height=455&name=qnap-map-container-storage.png)
7. Start with a clean slate by selecting the **Delete** ![Trash icon for Delete function.](https://massive.io/wp-content/uploads/2024/09/qnap-trash-delete-icon.png) icon to the right of the **Volume** box.
8. From the **Add Volume** menu, select **Bind Mount Host Path**.
9. To set a **Host** folder, select the yellow **Browse** button and navigate to the folder where you want to store the MASV configuration files. We’ll choose **masv/config**, and select **Apply**.![qnap-set-host-path](https://help.massive.io/hs-fs/hubfs/KB/qnap-set-host-path.webp?width=670&height=455&name=qnap-set-host-path.webp)
10. In the **Container** box, type **/config.** You can leave the **RW** setting (for Read/Write) as it is if you want to save files to and send files from storage.![qnap-storage-volume-settings](https://help.massive.io/hs-fs/hubfs/KB/qnap-storage-volume-settings.png?width=670&height=413&name=qnap-storage-volume-settings.png)
11. From the **Add Volume** menu, select **Bind Mount Host Path** again, and repeat the steps to map a folder where you files will be downloaded or uploaded from. For **Host** we suggest **masv/data** and for **Container** use **/data**.
12. Select **Apply** to close **Advanced Settings**, **Next**, and then **Finish**. In a few moments your new MASV Engine container displays in the **Containers** list.![qnap-final-container](https://help.massive.io/hs-fs/hubfs/KB/qnap-final-container.webp?width=670&height=181&name=qnap-final-container.webp)

### Create a secure connection between your QNAP NAS and MASV

After you create and configure the MASV Engine container on your QNAP device, you can finish setting up the integration by creating a secure connection between MASV and the device.

#### To connect a QNAP NAS to MASV

1. In the MASV Admin Console, as Team Owner or Admin ([role](https://help.massive.io/en/roles-and-permissions-in-masv?hsLang=en)), select **Integrations** from the sidebar on the left.
2. From the **Integrations** page, select the **Available Integrations** tab, and select **QNAP**.![masv-integrations-qnap](https://help.massive.io/hs-fs/hubfs/masv-integrations-qnap.png?width=644&height=215&name=masv-integrations-qnap.png)
3. In the **Add Integration** window, type a name in the **Connection Name** box.
4. ![masv-add-integration-qnap-2](https://help.massive.io/hs-fs/hubfs/masv-add-integration-qnap-2.png?width=446&height=499&name=masv-add-integration-qnap-2.png)In the **Transfer Direction** area, choose a direction:  
     1. **Save to storage**: For inbound files (Write)--MASV transfers files to the storage device.
     2. **Send from storage**: For outbound files (Read)--MASV transfers files out of the storage device.
5. Choose any of the following settings in **Folder Options** or **Source Directories**:
   
     1. [**Target Subdirectory**](https://help.massive.io/en/how-to-use-target-subdirectory?hsLang=en) (**Save to storage** direction only): To set an optional relative path, type a path in the **Target Subdirectory** box. You can edit this directory as needed.
     2. **Save directly in upload/target directory** (**Save to storage** direction only): If you want to save the files in a directory that uses the package name, clear the checkbox. To deliver directly into the **Target Subdirectory**, select the checkbox.
     3. **Source Directories** (**Send from storage** direction only): To limit access to a specific folder/directory, in **Source Directories**, type a relative path. You can edit this directory as needed.
6. (Optional for **Save to storage**) In **Sidecar Options**, if you are passing metadata to Mimir, enter a **Mimir Sidecar Form ID**.
7. Select **Next**.
8. In the **Register Integration** window, skip step 1 (assuming you have installed the MASV Engine by following the instructions at the top of this page), and copy the block of code from step 2.![masv-register-integration-qnap](https://help.massive.io/hs-fs/hubfs/KB/masv-register-integration-qnap.png?width=461&height=563&name=masv-register-integration-qnap.png)
9. In QNAP **Container Station**, select **Containers** in the sidebar, select your MASV container, and then select the **Execute** button. ![qnap-container-station-execute](https://help.massive.io/hs-fs/hubfs/KB/qnap-container-station-execute.webp?width=670&height=161&name=qnap-container-station-execute.webp)
10. In the **Execute Console**, select the **Execute** button.![qnap-execute-console](https://help.massive.io/hs-fs/hubfs/KB/qnap-execute-console.png?width=670&height=439&name=qnap-execute-console.png)
11. Paste the code block from MASV into the **Execute Console** Terminal panel.![qnap-execute-console-terminal-code](https://help.massive.io/hs-fs/hubfs/qnap-execute-console-terminal-code.png?width=622&height=403&name=qnap-execute-console-terminal-code.png)
12. In the Terminal panel, edit the placeholder text (**'/path/to/dir/'**) for the **root-path** to point to a pre-existing directory that you want to access. For example, if using the default path for the MASV Engine, replace **'/path/to/dir/'** with **'/data/'**.
13. (Optional) User and Group: You can configure user and group settings for your container. To see an example configuration, see [MASV Engine setup with Docker](https://developer.masv.io/agent/install-docker/#container-startup).<https://developer.masv.io/agent/install-docker/#container-startup>
14. Press **Enter**, and when the Terminal window responds with**“code”: 200**, select the **Done** button in the MASV Admin Console.![qnap-code-200](https://help.massive.io/hs-fs/hubfs/KB/qnap-code-200.png?width=454&height=126&name=qnap-code-200.png)
15. In the MASV Admin Console, select **Done** to close the **Register Integration** window. Your new integration displays in the list on the **My Integrations** tab. Refresh the page to update the **Status** column. **OK** displays if the connection is successful and ready to use.

**Note**: The MASV **Status** column indicates if a connection is registered. It does not indicate when a target device becomes unavailable, so monitor your destination device to ensure it is available for transfers.

### Save files to your QNAP NAS with MASV Portals

MASV Portals are web uploaders that make it easy to collect files from contributors and deliver them to your storage of choice. Lets take a look at how this process works with our new QNAP storage integration.

You’ll first need a MASV portal. If you don’t already have one set up, you can create one in the MASV Admin Console. For full instructions, see [How to create, edit, or delete a portal](https://help.massive.io/en/how-to-create-a-portal-in-masv?hsLang=en). You can create an Instant Portal in a couple of clicks, or create a Custom Portal that is brandable, sets file requirements, and collects metadata.

#### To save files to your QNAP NAS by using MASV Portals

1\. In the MASV Admin Console, select **Request Files with Portals** from the sidebar on the left.

2\. On the **Request Files** page, choose a **portal**, and in the **Actions** column, select the menu icon \[three vertical dots\], and select **Edit**.

3\. On the **Edit Portal** page, select the **Integrations** tab, and in the **Status** column, enable the toggle for your QNAP integration.

4\. Select the **Save** button in the lower right corner of the page to apply the changes.

5\. Return to the **Request Files** page. Now you’re ready to send a file request. Select the **Actions** menu icon for your portal, and select **Send Upload Request** from the menu.

6\. Fill in the **Send Upload Request Via Email** fields, adding the email recipients and the message that you want to send.

7\. Select the **Send Request** button to close the window. Recipients receive an email with a link to the portal upload page.

![](https://help.massive.io/hs-fs/hubfs/KB/masv-portal-upload-request.png?width=327&height=460&name=masv-portal-upload-request.png)

After the recipient uploads files, you'll receive an email confirming that a package has been delivered to your integration.

On your QNAP device, open **File Station**, and navigate to your mapped folder. If you didn’t set an optional **Target Directory** in MASV, your files are saved to the following default location: **Portal Downloads** \> \[Portal name\] \> \[Package name\].

![qnap-file-station-portal-delivery](https://help.massive.io/hs-fs/hubfs/KB/qnap-file-station-portal-delivery.png?width=670&height=268&name=qnap-file-station-portal-delivery.png)

**Tip**: You can monitor all sent or received packages efficiently using the MASV Admin Console. Navigate to **Transfer History**, access the **Received** tab to view a detailed delivery log of received packages. From here, you can also send any active package to integrations like QNAP by selecting the package, and from the **Actions** menu choosing **Send Package to Cloud**, and selecting the integration.

- [Get started with MASV](https://help.massive.io/en/get-started-with-masv?hsLang=en)
- [Send and request files](https://help.massive.io/en/send-and-request-files?hsLang=en#main-content)

    - [Send files](https://help.massive.io/en/send-and-request-files?hsLang=en#send-files)
    - [Request files with portals](https://help.massive.io/en/send-and-request-files?hsLang=en#request-files-with-portals)
    - [MASV Studio](https://help.massive.io/en/send-and-request-files?hsLang=en#masv-studio)
    - [Advanced settings](https://help.massive.io/en/send-and-request-files?hsLang=en#advanced-settings)
- [Apps & Integrations](https://help.massive.io/en/apps-integrations?hsLang=en#main-content)

    - [Working with integrations](https://help.massive.io/en/apps-integrations?hsLang=en#working-with-integrations)
    - [Cloud integrations](https://help.massive.io/en/apps-integrations?hsLang=en#cloud-integrations)
    - [On-premises and cloud storage devices](https://help.massive.io/en/apps-integrations?hsLang=en#on-premises-and-cloud-storage-devices)
    - [Asset management & collaboration](https://help.massive.io/en/apps-integrations?hsLang=en#asset-management-collaboration)
- [Teams and user management](https://help.massive.io/en/teams-and-user-management?hsLang=en#main-content)

    - [Teams](https://help.massive.io/en/teams-and-user-management?hsLang=en#teams)
    - [Roles & Teamspaces](https://help.massive.io/en/teams-and-user-management?hsLang=en#roles-teamspaces)
    - [Single Sign-On (SSO)](https://help.massive.io/en/teams-and-user-management?hsLang=en#single-sign-on-sso)
- [Manage file transfers](https://help.massive.io/en/manage-file-transfers?hsLang=en#main-content)

    - [Transfer History & Dashboard](https://help.massive.io/en/manage-file-transfers?hsLang=en#transfer-history-dashboard)
    - [Notifications](https://help.massive.io/en/manage-file-transfers?hsLang=en#notifications)
    - [Custom Metadata](https://help.massive.io/en/manage-file-transfers?hsLang=en#custom-metadata)
- [Account and billing](https://help.massive.io/en/account-and-billing?hsLang=en#main-content)

    - [Account](https://help.massive.io/en/account-and-billing?hsLang=en#account)
    - [Billing](https://help.massive.io/en/account-and-billing?hsLang=en#billing)
    - [Extended Storage](https://help.massive.io/en/account-and-billing?hsLang=en#extended-storage)
- [FAQs](https://help.massive.io/en/faqs?hsLang=en)
- [Releases](https://help.massive.io/en/releases?hsLang=en)
- [MASV Studio](https://help.massive.io/en/masv-studio?hsLang=en)

[![MASV\_Logo\_Colour\_2026](https://help.massive.io/hs-fs/hubfs/MASV_Logo_Colour_2026.png?width=100&height=25&name=MASV_Logo_Colour_2026.png "MASV_Logo_Colour_2026")](https://massive.io)

#### MASV Help Center

<https://www.youtube.com/c/MASVfast/> <https://www.linkedin.com/company/masv/>

**[MASV Service Status](https://masv.statuspage.io/)**

Copyright © 2026, MASV