How to connect MASV with a Synology storage device

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

Steps to use MASV with your Synology NAS include:

1. Install the Docker version of the MASV Agent on your Synology NAS via the Synology Container Manager app (available on the Synology DiskStation Manager (DSM) platform).
2. Create a secure connection to a Synology destination (directory you want to read or write to) in the MASV Web App.
3. Use MASV Portals to ingest files from contributors or send files to your Synology storage.

MASV Agent installation: For full MASV Agent installation instructions, including information about specific user and group settings, please visit MASV Agent setup with Docker . For the default installation, visit the tutorial page listed below.

Tutorial: A step-by-step MASV Agent installation and Synology integration guide.

To connect a Synology NAS to MASV

1. In the MASV Web App, as Team Owner, Admin, or Integration Manager (role), select Integrations from the sidebar on the left.
2. From the Integrations page, select the Available Integrations tab, and select Synology.
3. In the Add Integration window, type a name in the Connection Name box.
4. 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 (Save to Cloud 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 Cloud 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 Cloud 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) 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, if you have not already installed the MASV Agent on your storage device, select the Install MASV Agent button for information about installing the Docker version of the MASV Agent on your Synology NAS via the Synology Container Manager app (available on the Synology DiskStation Manager (DSM) platform).

   1. Tip: The tutorial for Synology walks you through the default MASV Agent installation.

      

9. In the Register Integration window, copy the block of code provided and paste it into the Container Manager Terminal window.

   1. Tip: You can find the Terminal window in Container Manager by selecting Container in the sidebar, selecting your MASV container, and choosing Open terminal from the Actions menu in the upper-right corner.
   2. Tip: If you run into issues pasting the code, try right-clicking with your mouse and selecting Paste from the context menu. You can also click the Hot Keys button in the upper-right corner of the Terminal window and follow the instructions for pasting.
10. In the Terminal window, 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 Agent, replace '/path/to/dir/' with '/data/'.
11. (Optional) User and Group: By default, user and group are set to Admin, so if you need other user and group settings, visit MASV Agent setup with Docker.
12. Press Enter, and when the Terminal window responds with “code”: 200, select the Done button in the MASV Web App.
13. 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.